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为 什么 写 这 本 书 


2007 年 的 时 候 ， 我 加 入 了 一 个 新 成 立 的 开发 团队 ， 我 们 一 起 做 一 
个 新 的 项 目 。 经 验 较 丰富 的 同事 习惯 性 地 开始 编写 Ant 脚 本 ， 也 有 人 项 
望 能 尝试 一 下 Maven。 当 时 我 比较 年 轻 ， 且 富有 激情 ， 因 此 大 家 决定 
让 我 对 Maven 做 些 研究 和 实践 。 于 十 我 慢 慢 开 始 学 习 并 推广 Maven ， 
这 期 间 有 人 文 持 ， 也 有 人 抵触 ， 而 我 则 尽力 地 为 大 家 排除 困难 ， 并 做 
一 些 内 部 交流 ， 源 渐 地 ， 抵 触 的 人 起 来 越 少 ， 我 的 工作 也 得 到 了 大 家 
的 认可 。 


为 什么 一 开始 有 人 会 抵触 这 一 优秀 的 技术 呢 ? 后 来 我 开始 反思 这 
一 经 历 ， 我 认为 Maven 陡 峭 的 学 习 曲 线 和 匮乏 的 文档 十 当时 最 主要 的 
问题 。 为 了 能 改善 这 个 问题 ， 我 开始 在 博客 中 撰写 各 类 关于 Maven 的 
中 文博 客 ， 翻 译 了 O”Reilly 出 版 的 《Maven 权 威 指南 》 一 书 ， 并 建立 了 
国内 的 Maven 中 文 社区 ， 不 定期 地 回答 各 类 Maven 相 关 问 题 ， 这 在 一 
定 程度 上 推动 了 Maven 这 一 优秀 的 技术 在 国内 的 传播 。 


后 来 我 加 入 了 Maven 之 父 Jason Van Zyl 创建 的 Sonatype， 参 与 
Nexus 的 开发 并 负责 维护 Maven 中 央 人 仓库， 这 些 工作 使 我 对 开源 和 
Maven 有 了 更 深 的 认识 ， 也 给 了 我 从 头 写 一 本 关于 Maven 的 书 的 信 


心 。 我 布 望 它 能 够 更 贴近 国内 的 技术 人 员 的 需求 ， 能 够 出 现在 书店 的 


该 书写 作 后 期 适 逢 Maven 3 的 发 布 ， 这 距离 我 刚 接触 Maven 时 已 经 
过 去 3 年 有 余 ， 感 叹 时 光 的 流逝 ! Maven 在 2007 年 至 2010 年 取得 了 飞速 
的 发 展 ， 现 在 几乎 已 经 成 为 了 所 有 Java 开 源 项 目的 标 配 ，Struts、 
Hibernate、Ehcache 等 知名 的 开源 项 目 都 使 用 Maven 进 行 管理 。 据 了 
解 ， 国 内 也 有 越 来 越 多 的 知名 的 软件 公司 开始 使 用 Maven 管 理 他 们 的 
项 目 ， 例 如 阿里 巴巴 和 淘宝 。 


本 书面 向 的 读者 


目 先 ， 本 书 适合 所 有 Java 程 序 员 阅读 。 由 于 目 动 化 构建 、 依 赖 管 
理 等 问题 并 不 只 存在 于 Java 世 界 ， 因 此 非 Java 程 序 员 也 能 够 从 该 书 中 
获 益 。 无 论 你 是 从 未 接触 过 Maven、 还 是 已 经 用 了 Maven 很 长 时 间 ， 
亦 或 者 想 要 扩展 Maven， 都 能 从 本 书 获 得 有 价值 的 参考 建议 。 


其 次 ， 本 书 也 适合 项 目 经 理 阅 读 ， 它 能 帮助 你 更 规范 、 更 高 效 地 


管理 Java 项 目 。 


本 书 的 主要 内 容 


第 1 章 对 Maven 做 了 位 要 介绍 ， 通 过 一 些 程序 员 熟 悉 的 例子 介绍 了 
Maven 是 什么 ， 为 什么 需要 Maven。 建 议 所 有 读者 都 阅读 以 获得 一 个 


大 局 的 印象 。 


第 2~3 章 是 对 Maven 的 一 个 入 门 介绍 ， 这 些 内 容 对 初学 者 很 有 帮 
助 ， 如 果 你 已 经 比较 熟悉 Maven， 可 以 跳 过 。 


第 4 章 介 绍 了 本 书 使 用 的 表 景 和 案例， 后面 的 很 多 章节 都 会 基于 该 案 
例 展开 ， 因 此 建议 读者 至 少 人 简单 浏览 一 授 。 


第 5~8 章 深入 阐述 了 Maven 的 核心 概念 ， 包 括 坐标 、 依 赖 、 仓 库 、 
生命 周期 、 插 件 、 继 承 和 多 模块 聚合 ， 等 等 ， 每 个 知识 点 都 有 实际 的 
案例 相 佐 ， 建 议 读者 仔细 阅读 。 


第 9 章 介绍 使 用 Nexus 建 立 私 服 ， 如 果 你 要 在 实际 工作 中 使 用 


Maven， 这 是 必 不 可 少 的 。 


第 10~16 章 介绍 了 一 些 相 对 高 级 且 离 散 的 知识 点 ， 包 括 测试 、 持 
续集 成 气 Hudson、Web 项 目 与 目 动 化 部 署 、 目 动 化 版 本 管理 、 智 能 逢 
应 环境 差异 的 灵活 构建 、 站 点 生成 ， 以 及 Maven 的 Eclipse 插件 
m2eclipse， 等 等 。 读 者 可 以 根据 上 自己 实际 需要 和 兴趣 选择 性 地 阅读 。 


第 17~18 章 介绍 了 如 何 编写 Archeype 和 Maven 插 件 。 一 般 的 Maven 
用 户 在 实际 工作 中 往往 不 需要 接触 这 些 知识 ， 如 果 你 需要 编写 揪 件 扩 
展 Maven， 或 者 需要 编写 Archetype 维 护 自 己 的 项 目 骨 架 以 方便 团队 开 
发 ， 那 么 可 以 仔细 阅读 这 两 章 的 内 容 。 


咖啡 与 工具 


本 书 相 当 一 部 分 的 内 容 是 在 苏州 十 全 街 边 的 Solo 咖 啡 馆 完 成 的 ， 
老板 Yin 亲 手 烘 焙 咖 啡 豆 、 并 能 做 出 据说 是 苏州 最 好 的 咖啡 ， 这 小 桥 流 
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啡 ， 让 我 能 够 每 天 在 家 里 也 能 亨 受 香气 四 海 的 新 鲜 咖啡 。 


本 书 的 书稿 是 使 用 Git 和 Unfuddle (http://unfuddle.com/) 进行 管理 
的 ， 书 中 的 大 量 截 图 是 通过 Jing (http://www.techsmith.com/jing/) 制作 
HJ ° 


JuvenXu 


2010 年 10 月 于 苏州 Solo 咖 啡 


致谢 


感谢 费 晓 峰 ， 是 你 最 早 让 我 学 习 使 用 Maven， 并 在 我 开始 学 习 的 
过 程 中 给 予 了 不 少 帮 助 。 


感谢 Maven 开 源 社 区 特别 是 Maven 的 创立 者 Jason Van Zyl， 是 你 们 
一 起 创造 了 如 此 优秀 的 开源 工具 ， 造 福 了 全 世界 这 么 多 的 开发 人 员 。 


感谢 我 的 家 人 ， 一 年 来 ， 我 的 大 部 分 原来 属于 你 们 的 业余 时 间 都 
给 了 这 本 书 ， 感 谢 你 们 的 理解 和 文 持 。 


感谢 二 少 、Garin、Sutra、JTIux、 红 人 、1linux_china、Chris、 
Jdonee、zc0922、 还 有 很 多 Maven 中 文 社区 的 朋友 ， 你 们 给 了 本 书 不 少 
建议 ， 并 在 我 写作 过 程 中 不 断 鼓 励 我 和 支持 我 ， 你 们 是 我 写作 最 大 的 
a A di 


最 后 感谢 本 书 的 策划 编辑 杨 福 川 和 曾 珊 ， 我 从 你 们 映 上 学 到 了 很 
多 ， 你 们 是 最 专业 的 、 最 棒 的 。 


第 1 革 Maven is 


` 何 为 Maven 

.为 什么 需要 Maven 
.Maven 与 极限 编程 
-被 误解 的 Maven 


-小结 


1.1 Maven 


Maven 这 个 词 可 以 翻译 为 "知识 的 积累 ”*， 也 可 以 翻译 为 “ 专 
家 ”或 “内 行 *”。 本 书 将 介绍 Maven 这 一 跨 平台 的 项 目 管 理工 具 。 作 为 
Apache 组 织 中 的 一 个 顾 为 成 功 的 开源 项 目 ，Maven 主 要 服务 于 基于 
Java 平 人 台 的 项 目 构建 、 依 赖 管理 和 项 目 信 息 管理 。 无 论 是 小 型 的 开源 
类 库 项 目 ， 还 是 大 型 的 企业 级 应 用 ; 无 论 古 传统 的 瀑布 式 开 发 ， 还 是 
流行 的 敏捷 模式 ，Maven 都 能 大 显 吴 手 。 


1.1.1 何 为 构建 


不 管 你 是 否 意识 到 ， 构 建 (build) 是 每 一 位 程序 员 每 天 都 在 做 的 
工作 。 早 上 来 到 公司 ， 我 们 做 的 第 一 件 事 情 殉 是 从 源码 库 等 出 最 新 的 
源码 ， 然 后 进行 单元 测试 ， 如 果 发 现 失 败 的 测试 ， 会 找 相关 的 同事 一 
起 调试 ， 修 复 错误 代码 。 接 着 回 到 目 己 的 工作 上 来 ， 编 写 目 己 的 单元 
测试 及 产品 代码 ， 我 们 会 感激 IDE 随 时 报 出 的 编译 错误 提示 。 


忙 到 午饭 时 间 ， 代 码 编写 得 差不多 了 ， 测 试 也 通过 了 ， 开 心地 享 
用 午餐 ， 然 后 休息 。 下 午 先 在 氏 错 沉沉 中 开 了 个 例会 ， 会 议 结束 后 喝 
杯 咖啡 继续 工作 。 刚 才 在 会 上 经 理 要 求 看 测试 报告 ， 于 是 找 了 相关 工 
具 集 成 进 IDE， 生 成 了 像 模 像样 的 测试 覆盖 率 报告 ， 接 着 发 了 一 封 电 
子 邮件 给 经 理 ， 松 了 口气 。 谁 料 QA 小 组 又 发 过 来 了 几 个 bug， 没 办 
法 ， 先 本 地 重 现 再 说 ， 于 是 熟练 地 用 IDE 生 成 了 一 个 WAR 包 ， 部 署 到 
Web 容 器 下 ， 启 动容 器 。 看 到 熟悉 的 界面 了 ， 遵 循 bug 报 告 ， 一 步 步 重 
现 了 bug.………. 快 下 班 的 时 候 ，bug 修 好 了 ， 提 交 人 代码， 通知 QA 人 小 组 ， 在 
愉快 中 结束 了 一 天 的 工作 。 


仔细 总 结 一 下 ， 我 们 会 发 现 ， 除 了 编写 源 代码 ， 我 们 每 天 有 相当 
一 部 分 时 间 花 在 了 编译 、 运 行 单元 测试 、 生 成 文档 、 打 包 和 部 署 等 烦 
琐 且 不 起 眼 的 工作 上 ， 这 吏 是 构建 。 如 有 果 我 们 现在 还 手工 这 样 做 ， 那 


成 本 也 太 高 了 ， 于 是 有 人 用 软件 的 方法 让 这 一 系列 工作 完全 目 动 化 ， 
使 得 软件 的 构建 可 以 像 全 目 动 流水 线 一 样 ， 只 需要 一 条 简单 的 命令 ， 
所 有 烦琐 的 步骤 都 能 够 目 动 完成 ， 很 快 束 能 得 到 最 终结 果 。 


1.1.2 ” Maven 是 优秀 的 构建 工具 


前 面 介绍 了 Maven 的 用 途 之 一 是 服务 于 构建 ， 它 是 一 个 异 闻 强大 
的 构建 工具 ， 能 够 帮 有 我 们 目 动 化 构建 过 程 ， 从 清理 、 编 译 、 测 试 到 生 
成 报告 ， 再 到 打包 和 部 署 。 我 们 不 需要 也 不 应 该 一 过 又 一 人 吉 地 输入 命 
令 ， 一 次 又 一 次 地 点 击 鼠 标 ， 我 们 要 做 的 是 使 用 Maven 配 置 好 项 目 ， 
然后 输入 简单 的 命令 (如 mvn clean install) ，Maven 会 帮 有 我 们 处 理 那 
些 烦琐 的 任务 。 


Maven 是 跨 平 台 的 ， 这 意味 着 无 论 是 在 Windows 上 ， 还 是 在 Linux 
或 者 Mac 上 ， 都 可 以 使 用 同样 的 命令 。 


我 们 一 直 在 不 停 地 寻找 避免 重复 的 方法 。 设 计 的 重复 、 编 码 的 重 
复 、 文 档 的 重复 ， 当 然 还 有 构建 的 重复 。Maven 最 大 化 地 消除 了 构建 
的 重复 ， 抽 象 了 构建 生命 周期 ， 并且 为 绝 大 部 分 的 构建 任务 提供 了 已 
实现 的 插件 ， 我 们 不 再 需要 定义 过 程 ， 甚 至 不 需要 再 去 实现 这 些 过 程 
中 的 一 些 任务 。 最 简单 的 例子 古 测试 ， 我 们 没 必要 告诉 Maven 去 测 
试 ， 更 不 需要 告诉 Maven 如 何 运行 测试 ， 只 需要 遵循 Maven 的 约定 编 
写 好 测试 用 例 ， 当 我 们 运行 构建 的 时 候 ， 这 些 测试 便 会 目 动 运行 。 


想象 一 下 ，Maven 抽 象 了 一 个 完整 的 构建 生命 周期 模型 ， 这 个 模 
型 吸取 了 大 量 其 他 的 构建 脚本 和 构建 工具 的 优点 ， 总 结 了 大 量 项 目的 


实际 需求 。 WARTS RAY, BT GEIR DORER, AE 
接 使 用 大 量 成 熟 的 Maven 插 件 来 完成 我 们 的 任务 (很 多 时 候 我 们 可 能 
都 不 知道 自己 在 使 用 Maven 插 件 ) 。 此 外 ， 如 果 有 非常 特殊 的 需求 ， 
我 们 也 可 以 轻松 实现 目 己 的 插件 。 


Maveni 还 有 一 个 优点 ， 它 能 帮助 我 们 标准 化 构建 过 程 。 在 Maven 
之 前 ， 十 个 项 目 可 能 有 十 种 构建 方式 ， 有 了 Maven 之 后 ， 所 有 项 目的 
构建 命令 都 是 简单 一 致 的 ， 这 极 大 地 避免 了 不 必要 的 学 习 成 本 ， 而 且 
有 利于 促进 项 目 团队 的 标准 化 。 


综 上 所 述 ，Maven 作 为 一 个 构建 工具 ， 不 仅 能 帮 我 们 目 动 化 构 
建 ， 还 能 够 抽象 构建 过 程 ， 提 供 构 建 任务 实现 ， 它 跨 平 台 ， 对 外 提供 
了 一 致 的 操作 接口 ， 这 一 切 足 以 使 它 成 为 优秀 的 、 流 行 的 构建 工具 。 


1.1.3. “Maven 不 仅仅 是 构建 工具 


Java 不 仅 是 一 门 编程 语言 ， 还 是 一 个 平台 ， 通 过 JRuby 和 Jython ， 
我 们 可 以 在 Java 平 台 上 编写 和 运行 Ruby 和 Python 程序 。 我 们 也 应 该 认 
识 到 ，Maven 不 仅 是 构建 工具 ， 还 是 一 个 依赖 管理 工具 和 项 目 信 息 管 
理工 具 。 它 提供 了 中 央 仓 库 ， 能 帮 我 们 自动 下 载 构 件 。 


在 这 个 开源 的 年 代 里 ， 几 乎 任何 Java 应 用 都 会 借用 一 些 第 三 方 的 
开源 类 库 ， 这 些 类 库 都 可 通过 依赖 的 方式 引入 到 项 目 中 来 。 随 着 依赖 
的 增多 ， 版 本 不 一 致 、 版 本 冲突 、 依 赖 腾 肿 等 问题 都 会 接 题 而 来 。 手 
工 解决 这 些 问题 是 十 分 枯燥 的 ， 笠 运 的 是 Maven 提 供 了 一 个 优秀 的 解 
决 方案 ， 它 通过 一 个 坐标 系统 准确 地 定位 每 一 个 构件 (artifact) ， 也 
就 是 通过 一 组 坐标 Maven 能 够 找到 任何 一 个 Java 类 库 (如 jar 文 件 ) ° 
Maven 给 这 个 类 库 世 界 引 入 了 经 纬 ， 让 和 它们 变 得 有 秩序 ， 于 十 我 们 可 
以 借助 它 来 有 序 地 管理 依赖 ， 轻 松 地 解决 那些 索 杂 的 依赖 问题 。 


Maven 还 能 帮助 我 们 管理 原本 分 散在 项 目 中 各 个 角落 的 项 目 信 
思 ， 包 括 项 目 搞 述 、 开 发 者 列表 、 版 本 控制 系统 地 址 、 许 可 证 、 缺 陷 
管理 系统 地 址 等 。 这 些微 小 的 变化 看 起 来 很 琐碎 ， 并 不 起 腿 ， 但 却 在 
不 知 不 觉 中 为 我 们 和 节省 了 大 量 寻 找 信息 的 时 间 。 除 了 直接 的 项 目 信 
思 ， 通 过 Maven 目 动 生成 的 站 点 ， 以 及 一 些 已 有 的 插件 ， 我 们 还 能 够 


轻松 获得 项 目 文档 、 测 试 报告 、 静 仿 分 析 报 告 、 源 码 版 本 日 志 报 告 等 
非 党 具有 价值 的 项 目 信 息 。 


Maven 还 为 全 世界 的 Java 开 发 者 提供 了 一 个 免费 的 中 央 仓 库 ， 在 
其 中 几乎 可 以 找到 任何 的 流行 开源 类 库 。 通 过 一 些 Maven 的 衍生 工具 
(如 Nexus) ， 我 们 还 能 对 其 进行 快速 地 搜索 。 只 要 定位 了 坐标 ， 
Maven 束 能 够 帮 我 们 目 动 下 载 ， 省 去 了 手工 劳动 。 


使 用 Maven 还 能 享受 一 个 额外 的 好 处 ， 即 Maven 对 于 项 目 目 孙 结 
构 、 测 试用 例 命 名 方式 等 内 容 都 有 既定 的 规则 ， 只 要 遵循 了 这 些 成 熟 
的 规则 ， 用 户 在 项 目 间 切换 的 时 候 就 免 去 了 额外 的 学 习 成 本 ， 可 以 说 


EANET AE (Convention Over Configuration) ° 


1.2 ”为 什么 需要 Maven 


Maven 不 十 Java 领 域 唯一 的 构建 管理 的 解决 方案 。 本 市 将 通过 一 
些 简单 的 例子 解释 Maven 的 必要 性 ， 并 介绍 其 他 构建 解决 方案 ， 如 


IDE、Make 和 Ant， 并 将 它们 与 Maven 进 行 比较 。 


1.2.1 组 装 PC 和 品牌 PC 


笔者 初中 时 开始 接触 计算 机 ， 到 了 高 中 时 更 是 梦 才 以 求 布 望 拥有 
一 人 台 目 己 的 计算 机 。 我 的 第 一 侣 计算机 征 赛 扬 733 的 ， 选 购 是 一 个 漫长 
的 过 程 ， 我 先 阅读 了 大 量 的 杂志 以 了 解 各 类 配件 的 优 务 ，CPU、 内 
存 、 主 板 、 显 卡 ， 攻 至 声卡 ， 我 都 仔细 地 挑选 ， 后 来 还 跑 了 很 多 商 
家 ， 调 货 、 讨 价 还 价 ， 组 装 好 后 目 己 疼 操 作 系统 和 驱动 程序 .…… 虽 然 
这 伦 费 了 我 大 量 时 间 ， 但 我 很 持 受 这 个 过 程 。 可 是 事实 证 明 ， 闭 出 来 
的 机 需 稳 定性 不 怎么 好 。 


一 年 前 我 需要 配 一 台 工作 站 ， 这 时 候 我 已 经 没有 太 多 时 间 去 研究 
电脑 配件 了 。 我 选择 了 茶 知名 PC 供应 两 的 在 线 丙 店 ， 大 概 浏 览 了 一 下 
主流 的 机 型 ， 选 择 了 我 需要 的 配置 ， 然 后 下 单 、 人 付款。 接着 PC 供应 两 
帮 我 组 闭 电 脑 、 安 痛 操 作 系统 和 驱动 程序 。 一 周 后 ， 物 流 公司 将 电脑 
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这 为 我 万 省 了 大 量 时 间 ， 而 且 这 合 电脑 十 分 稳定 ， 商 家 在 把 电脑 发 送 
给 我 之 前 已 经 进行 了 很 好 的 测试 。 对 了 ， 我 还 能 享受 两 年 的 售后 服 


务 。 


使 用 脚本 建立 高 度 目 定义 的 构建 系统 殉 像 天 组 猴 PC， 耗 时 费力 ， 
结 采 也 不 一 定 很 好 。 当 然 ， 你 可 以 至 受 从 无 到 有 的 乐趣 ， 但 何 怕 实际 


项 目 中 无 法 给 你 那么 多 时 间 。 使 用 Maven 就 像 购 买 品牌 PC， 省 时 省 
力 ， 并 能 得 到 成 熟 的 构建 系统 ， 还 能 得 到 来 自 于 Maven 社 区 的 大 量 文 
持 。 唯 一 与 购买 品牌 PC 不 同 的 是 ，Maven 是 开源 的 ， 你 无 须 为 此 付 
费 。 如 果 有 兴趣 ， 你 还 能 去 了 解 Maven 是 如 何 工作 的 ， 而 我 们 无 法 知 
道 那 些 PC 巨头 的 商业 秘密 。 


1.2.2 IDE 不 是 万 能 的 


当然 ， 我 们 无 法 否认 优秀 的 IDE 能 大 大 提高 开发 效率 。 当 前 主流 
的 IDE 如 Eclipse 和 NetBeans 等 都 提供 了 强大 的 文本 编辑 、 调 试 甚至 重 构 
功能 。 虽 然 使 用 简单 的 文本 编辑 器 和 命令 行 也 能 完成 绝 大 部 分 开发 工 
作 ， 但 很 少 有 人 愿意 那样 做 。 然 而 ，IDE 是 有 其 天 生 缺 陷 的 : 


IDE 依 赖 大 量 的 手工 操作 。 编 译 、 测 试 、 代 码 生成 等 工作 都 是 相 
互 独立 的 ， 很 难 一 键 完成 所 有 工作 。 手 工 劳动 往往 意味 着 低 效 ， 意 味 
着 容易 出 错 。 


.很 难 在 项 目 中 统一 所 有 的 IDE 配 置 ， 每 个 人 都 有 自己 的 喜好 。 也 
正 是 由 于 这 个 原因 ， 一 个 在 机 器 A 上 可 以 成 功 运行 的 任务 ， 到 了 机 器 B 
的 IDE 中 可 能 束 会 失败 。 


我 们 应 该 合理 利用 IDE， 而 不 是 过 多 地 依赖 它 。 对 于 构建 这 样 的 
任务 ， 在 IDE 中 一 次 次 地 点 击 里 标 是 思春 的 行为 。Maven 是 这 方面 的 专 
家 ， 而 且 主 流 IDE 都 集成 了 Maven， 我 们 可 以 在 IDE 中 方便 地 运行 
Maven 执 行 构建 。 


1.2.3 Make 


Make 也 许 是 最 早 的 构建 工具 ， 它 由 Stuart Feldman }1977*F 7£Bell 
实验 室 创 建 。Stuart Feldman 也 因此 于 2003 年 获得 了 ACM 国 际 计 算 机 组 
织 颁 发 的 软件 系统 天。 目前 Make 有 很 多 衍生 实现 ， 包 括 节 流行 的 GNU 
Make 和 BSD Make， 还 有 Windows 平 台 的 Microsoft nmake 等 。 


Make 由 一 个 名 为 Makefile 的 脚本 文件 驱动 ， 该 文件 使 用 Make 目 己 
定义 的 语法 格式 。 其 基本 组 成 部 分 为 一 系列 规则 (Rules) ， 而 每 一 
规则 又 包括 目标 (Target) 、 依 赖 (Prerequisite) 和 命令 

(Command) 。Makefile 的 基本 结构 如 下 : 


TARGET... : PREREQUISITE... 
COMMAND 


Make 通 过 一 系列 目标 和 依赖 将 整个 构建 过 程 串 联 起 来 ， 同 时 利用 
本 地 命令 完成 每 个 目标 的 实际 行为 。Make 的 强大 之 处 在 于 它 可 以 利用 
所 有 系统 的 本 地 命令 ， 尤 其 是 UNIX/Linux 系 统 ， 丰 富 的 功能 、 强 大 的 
命令 能 够 帮助 Make 快 速 高 效 地 完成 任务 。 


但 是 ，Make 将 目 己 和 操作 系统 绑 定 在 一 起 了 。 也 融 是 说 ， 使 用 
Make， 束 不 能 实现 (EDR) 路 平台 的 构建 ， 这 对 于 Java 来 说 是 非 


种 不 友好 的 。 此 外 ，Makefile 的 语法 也 成 问题 ， 很 多 人 抱怨 Make 构 建 
失败 的 原因 往往 是 一 个 难以 发 现 的 空格 或 Tab 使 用 错误 。 


1.2.4 Ant 


Ant 不 是 指 蚂蚁 ， 而 是 意 指 “ 男 一 个 整洁 的 工具 ” (Another Neat 
Tool) ， 它 最 早 用 来 构建 著名 的 Tomcat， 其 作者 James Duncan Davidson 
创作 它 的 动机 就 是 因为 受 不 了 Makefile 的 语法 格式 。 我 们 可 以 将 Ant 看 
成 是 一 个 Java 版 本 的 Make， 也 正 因 为 使 用 了 Java，Ant 是 路 平台 的 。 此 
外 ，Ant 使 用 XML 定义 构建 脚本 ， 相 对 于 Makefile 来 说 ， 这 也 更 加 友 
UF ° 


与 Make 类 似 ，Ant 有 一 个 构建 脚本 build.xml， 如 下 所 示 : 


<?xml version ="1.0"?> 
<project name = "Hello" default = "compile" > 
<target name = "compile" description = "compile the Java source code to class 


LICE 
r dir ="classes"/> 
vac srceåir =". " destdir ="classes"/> 
< /ti > 
<target name = "jar" depends = "compile" description = "create a Jar file "> 


<jar destfile = "hello. jar" > 
<fileset dir = "classes" includes ="* » /x .class"/> 
<manifest > 
<attribute name = "Main-Class" value = "HelloProgram"/> 


/maniftest > 


build.xml 的 基本 结构 也 是 目标 (target) 、 依 赖 (depends) , LA 
实现 目标 的 任务 。 比 如 在 上 面 的 脚本 中 ，jar 目 标 用 来 创建 应 用 程序 jar 
文件 ， 该 目标 依赖 于 compile 目 标 ， 后 者 执行 的 任务 是 创建 一 个 名 为 


classes 的 文件 夹 ， 编 译 当 前 目 孙 的 java 文 件 至 classes 目 未。compile 目 标 
完成 后 ，jar 目 标 再 执行 自己 的 任务 。Ant 有 大 量 内 置 的 用 Java 实 现 的 任 
务 ， 这 保证 了 其 跨 平台 的 特质 ， 同 时 ，Ant 也 有 特殊 的 任务 exec 来 执行 


本 地 命令 。 


和 Make 一 样 ，Ant 也 都 是 过 程式 的 ， 开 发 者 显 式 地 指定 每 一 个 目 
标 ， 以 及 完成 该 目标 所 需要 执行 的 任务 。 针 对 每 一 个 项 目 ， 开 发 者 都 
需要 重新 编写 这 一 过 程 ， 这 里 其 实 隐 含 着 很 大 的 重复 。Maven 是 声明 式 
的 ， 项 目 构 建 过 程 和 过 程 各 个 阶段 所 需 的 工作 都 由 插件 实现 ， 并 且 大 
部 分 插件 都 是 现成 的 ， 开 发 者 只 需要 声明 项 目的 基本 元 素 ，Maven 距 执 
行内 置 的 、 完 整 的 构建 过 程 。 这 在 很 大 程度 上 消除 了 重复 。 


Ant 是 没有 依赖 管理 的 ， 所 以 很 长 一 段 时 间 Ant 用 户 都 不 得 不 手工 
管理 依赖 ， 这 是 一 个 令 人 头疼 的 问题 。 幸 运 的 是 ，Ant 用 户 现 在 可 以 偿 
助 Ivy 管 理 依赖 。 而 对 于 Maven 用 户 来 说 ， 依 赖 管理 是 理所当然 的 ， 
Maven 不 仅 内 置 了 依赖 管理 ， 更 有 一 个 可 能 拥有 全 世界 最 多 Java 开 源 软 
件 包 的 中 央 仓 库 ，Maven 用 户 无 须 进行 任何 配置 束 可 以 直接 享用 。 
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小 张 是 一 家 小 型 民营 软件 公司 的 程序 员 ， 他 所 在 的 公司 要 开发 一 
个 新 的 web 项 目 。 经 过 协商 ， 决 定 使 用 Spring、iBatis 和 Tapstry。jar 包 
EMERI? 公司 里 估计 没有 人 能 把 Spring、iPBatis 和 Tapstry 所 使 用 的 
jar 包 一 个 不 少 地 找 出 来 。 大 家 的 做 法 是 ， 先 到 Spring 的 站 点 上 去 找 一 
个 spring-with-dependencies， 然 后 去 iBatis 的 网 站 上 把 所 有 列 出 来 的 jar 
包 下 载 下 来 ， 对 Tapstry、Apache commons 等 执行 同样 的 操作 。 项 目 还 
没有 开始 ，WEB-INF/lib 下 已 经 有 近 百 个 jar 包 了 ， 带 版 本 号 的 、 不 带 
版 本 号 的 、 有 用 的 、 没 用 的 、 相 冲突 的 ， 怎 一 个 “ 乱 ?” 字 了 得 ! 


在 项 目 开 发 过 程 中 ， 小 张 不 时 地 发 现 版 本 错误 和 版 本 冲突 问题 ， 
他 只 能 硬 着 头皮 逐一 解决 。 项 目 开 发 到 一 半 ， 经 理发 现 最 终 部 闭 的 应 
用 的 体积 实在 太 大 了 ， 要 求 小 张 去 挥 一 些 没 用 的 jar 包 ， 于 是 小 张 只 能 
加 班 加 点 地 一 个 个 删 .……… 


小 张 隐 隐 地 觉得 这 些 依赖 需要 一 个 框架 或 者 系统 来 进行 管理 。 


小 张 喜欢 学 习 流 行 的 技术 ， 前 几 年 Ant 十 分 流行 ， 他 学 了 ， 并 成 为 
了 公司 这 方面 的 专家 。 小 张 知道 ，Ant 打 包 ， 无 非 就 是 创建 和 目录， 复制 
文件 ， 编 译 源 代码 ， 使 用 一 堆 任 务 ， 如 copydir、fileset > classpath ` 
ref、target， 然 后 再 jar、zip、war， 打 包 就 成 功 了 。 


项 目 经 理发 话 了 : AA, SAART, MK, MRE Ani 
a» 


“是 ， 保 证 完成 任务 ! "REE, 7) RARE AES PTA XML MHF © 
target clean; target compile; target jar; ...... 不 知道 他 是 否 想 过 ， 在 他 
写 的 这 么 多 的 Ant 脚 本 中 ， 有 多 少 是 重复 劳动 ， 有 多 少 代码 会 在 一 个 又 
一 个 项 目 中 重 现 。 既 然 都 差不多 ， 有 些 甚 至 完全 相同 ， 为 什么 每 次 都 
要 重新 编写 ? 


终于 有 一 天 ， 小 张 意识 到 了 这 个 问题 ， 想 复 用 Ant 脚 本 ， 于 是 在 开 
会 时 他 说 : “以 后 承 都 用 我 这 个 规范 的 Ant 脚 本 吧 ， 新 的 项 目 只 要 遵循 
我 定义 的 目录 结构 束 可 以 了 。?” 经 理 听 后 觉得 很 有 道理 : “WE, BSR 


个 进步 。” 


这 时 新 来 的 研究 生发 言 了 : “经 理 ， 用 Maven 吧 ， 这 个 在 开源 社区 
很 流行 ， 比 Ant 更 方便 。?" 小 张 一 听 很 惊讶 ，Maven 真 比 目 己 的 “规范 化 
Ant” 强 大 ? 其实 他 不 知道 目 己 只 是 在 重新 发 明 轮 子 ，Maven 已 经 有 一 
大 把 现成 的 插件 ， 全 世界 都 在 用 ， 你 目 己 不 用 写 任 何 代码 ! 


为 什么 没有 人 说 “我 目 己 写 的 代码 最 灵活 ， 所 以 我 不 用 Spring， 我 
自己 实现 I[oC， 我 不 用 Hibermate， 我 自己 封装 JDBC”? 


[1] 该 小 节 内 容 整 理 自 网 友 Arthas 最 早 在 Maven 中 文 MSN 群 中 的 讨论 ， 
在 此 表示 感谢 


1.3 ”Maven 与 极限 编程 


极限 编程 (XP) 是 近 些 年 在 软件 行业 红 得 发 紫 的 敏捷 开发 方法 ， 
它 强 调 拥抱 变化 。 该 软件 开发 方法 的 创始 人 Kent Beck 提 出 了 XP 所 退 求 
的 价值 、 实 施 原则 和 推荐 实践 。 下 面 看 一 下 Maven 是 如 何 适应 XP 的 。 


首先 看 一 下 Maven 如 何 帮 助 XP 团 队 实现 一 些 核心 价值 : 


和 侧 单 。Maven 又 露 了 一 组 一 致 、 简 污 的 操作 接口 ， 能 帮助 团队 成 
员 从 原来 的 高 度 目 定义 的 、 复 杂 的 构建 系统 中 解脱 出 来 ， 使 用 Maven 
现 有 的 成 熟 的 、 稳 定 的 组 件 也 能 简化 构建 系统 的 复杂 度 。 


-交流 与 反馈 。 与 版 本 控制 系统 结合 后 ， 所 有 人 都 能 执行 最 新 的 构 
建 并 快速 得 到 反馈 。 此 外 ， 目 动 生成 的 项 目 报告 也 能 帮助 成 员 了 解 项 
目的 状态 ， 促 进 团 队 的 交流 。 


此 外 ，Maven 更 能 无 颖 地 支持 或 者 融入 到 一 些 主要 的 XP 实践 中 : 
:测试 驱动 开发 (TDD) 。TDD 强 调 测试 先行 ， 所 有 产品 都 应 该 由 
测试 用 例 覆 盖 。 而 测试 是 Maven 生 命 周 期 的 最 重要 的 组 成 部 分 之 一 ， 


并 且 Maven 有 现成 的 成 熟 插件 文 持 业 界 流 行 的 测试 框架 ， 如 JUnit 和 
TestNG ° 


十 分 钟 构建 。 十 分 钟 构建 强调 我 们 能 够 随时 快速 地 从 源码 构建 册 
最 终 的 产品 。 这 正 是 Maven 所 擅长 的 ， 只 需要 一 些 配置 ， 之 后 用 一 
简单 的 命令 就 能 让 Maven 帮 你 清理 、 编 译 、 测 试 、 打 包 、 部署， 然后 

产品 。 


得 到 最 终 的 


寺 续集 成 (CI) ° CI 强调 项 目 以 很 短 的 周期 (如 15 分 钟 ， 集 成 最 
新 的 代码 。 实 际 上 ，CI 的 前 提 是 源码 管理 系统 和 构建 系统 。 目 前 业界 
流行 的 CI 服务 器 如 Hudson 和 CruiseControl 都 能 很 好 地 和 Maven 进 行 集 
成 。 也 束 是 说 ， 使 用 Maven 后 ， 持 续集 成 会 变 得 更 加 方便 。 


富有 信息 的 工作 区 。 这 条 实践 强调 开发 者 能 够 快速 方便 地 了 解 到 
项 目的 最 新 状态 。 当 然 ，Maven 并 不 会 帮 你 把 测试 履 盖 率 报 告 贴 到 墙 
上 ， 也 不 会 在 你 的 工作 台 上 放 个 鸭子 告诉 你 构建 失败 了 。 不 过 使 用 
Maven 发 布 的 项 目 报告 站 点 ， 并 配置 你 需要 的 项 目 报告 ， 如 测试 履 疙 
率 报告 ， 都 能 帮 你 把 信息 推送 到 开发 者 眼前 。 


上 述 这 些 实践 并 非 只 在 XP 中 适用 。 事 实 上 ， 除 了 其 他 敏捷 开发 方 
法 如 SCRUM 之 外 ， 几 乎 任何 软件 开发 方法 都 能 借鉴 这 些 实践 。 也 就 是 
说 ，Maven 几 乎 能 够 很 好 地 支持 任何 软件 开发 方法 。 


例如 ， 在 传统 的 瀑布 模型 开发 中 ， 项 目 依 次 要 经 历 需 求 开发 、 
析 、 设 计 、 编 码 、 测 试 和 集成 发 布 阶段 。 从 设计 和 编码 阶段 开始 ， 束 
可 以 使 用 Maven 来 建立 项 目的 构建 系统 。 在 设计 阶段 ， 也 完全 可 以 针 


对 设计 开发 测试 用 例 ， 然 后 再 编写 代码 来 满足 这 些 测试 用 例 。 然 而 ， 
有 了 目 动 化 构建 系统 ， 我 们 可 以 节省 很 多 手动 的 测试 时 间 。 此 外 ， 
早 地 使 用 构建 系统 集成 团队 的 代码 ， 对 项 目 也 是 百 利 而 无 一 

后 ，Maven 还 能 帮助 我 们 快速 地 发 布 项 目 。 


1.4 ”被 误解 有 的 Maven 


C++ 之 父 Bjarne Stroustrup 说 过 一 句 话 : “只 有 两 类 计算 机 语言 ， 一 
类 语言 天 天 被 人 骂 ， 还 有 一 类 没 人 用 。?” 当 然 这 话 也 不 全 对 ， 大 红 大 紫 
的 Ruby 不 仅 有 人 用 ， 而 且 回 的 人 也 少 。 用 户 最 多 的 Java 得 到 的 回声 就 
不 绝 于 耳 了。Maven 的 用 户 也 不 少 ， 它 的 邮件 列表 目前 在 Apache 项 目 
中 排名 第 4 (http://www.nabble.com/Apache-f 90.html) 


让 我 们 看 看 Maven 受 到 了 哪些 质疑 ， 笔 者 将 对 这 些 质疑 逐一 解 


“Maven 对 于 IDE (如 Eclipse 和 IDEA) 的 支持 较 差 ，bug 多 ， 而 且 
不 稳定 。” 


相对 于 JUnit 和 Ant 来 说 ，Maven 比 较 年 轻 ，IDE 集 成 等 衍生 产品 还 
不 够 全 面 和 成 熟 。 但 是 ， 我 们 一 定 要 知道 ， 使 用 Maven 最 高 效 的 方式 
永远 是 命令 行 ，IDE 在 目 动 化 构建 方面 有 天 生 的 缺陷 。 此 外 ，Eclipse 
的 Maven 插 件 一 一 m2eclipse 是 一 个 比较 优秀 和 成 熟 的 工具 ，NetBeans 
也 在 积极 地 为 更 好 地 集成 Maven 而 努力 ， 目 IntelliJ IDEA 开 源 后 ， 也 有 
望 看 到 其 对 Maven 更 好 的 集成 。 


“<Maven 采 用 了 一 个 糟糕 的 插件 系统 来 执行 构建 ， 新 的 、 破 损 的 插 
件 会 让 你 的 构建 莫名 其 妙 地 失败 。” 


E Maven 2.0.9 开 始 ， 所 有 核心 的 插件 都 设 定 了 稳定 版 本 ， 这 意味 
着 日 党 使 用 Maven 时 儿 乎 不 会 受到 不 稳定 插件 的 影响 。 此 外 ，Maven 
社区 也 提倡 为 你 使 用 的 任何 插件 设 定 稳定 的 版 本 。 如 果 我 们 有 好 的 实 
践 不 采纳 ， 明 到 了 问题 束 抱 息 ， 未 人 免 不 够 公允 。 从 Maven 3 开始 ， 如 有 宁 
你 使 用 插件 时 未 设 定 版 本 ， 会 看 到 警告 信 


“Maven 过 于 复杂 ， 它 就 是 构建 系统 的 EJB 2 。 


不 要 指望 Maven 十 分 商 单 ， 这 几乎 是 不 可 能 的 。Maven 是 用 来 管 
理 项 上 目的， 清理、 编译 、 测 试 、 打 包 、 发 布 ， 以 及 一 些 目 定义 的 过 程 
本 身 束 是 一 件 复 洒 的 事情 。 目 前 在 Java 社 区 还 有 比 Maven 更 强大 、 更 
简单 的 构建 工具 吗 ? 管 案 是 否定 的 。 我 们 可 以 笑 试 去 帮助 Maveni 上 它 
变 得 更 简单 ， 而 不 是 抛 痉 它 ， 然 后 目 己 实现 一 父 更 加 复杂 的 构建 系 


统 。 


“Maven 的 仓库 十 分 混乱 ， 当 无 法 从 仓库 中 得 到 需要 的 类 库 时 ， 我 
需要 手工 下 载 复制 到 本 地 仓库 中 。” 


Maven 的 中 央 仓 库 确实 不 完美 ， 你 也 许 会 发 现 某 个 jar 包 出 现在 两 
个 不 同 的 路 径 下 。 这 不 是 Maven 的 错 ， 这 是 开源 项 目 本 号 改变 了 目 吴 
的 坐标 。 如 采 没 有 中 央 仓 库 ， 你 将 不 得 不 去 开源 项 目 首 页 寻找 下 载 链 
接 ， 这 不 是 更 费事 吗 ? 现在 有 很 多 的 Maven 仓 库 搜 索 服 务 。 无 法 从 中 
央 仓 库 找到 你 需要 的 类 库 ? 由 于 许可 证 等 因素 ， 这 是 完全 有 可 能 的 ， 


这 时 你 需要 做 的 是 建立 一 个 组 织 内 部 的 仓库 服务 磊 ， 你 会 发 现 这 会 给 
你 市 来 许多 意 想 不 到 的 好 处 。 


“缺乏 文档 是 理解 和 使 用 Maven 的 一 个 主要 障碍 ! ” 


这 是 事实 。Maven 官 方 站 点 的 文档 十 分 凌乱 ， 各 种 插件 的 文档 更 
是 需要 费力 寻找 。Sonatype 编 写 的 《Maven 权 威 指南 》 很 好 地 改善 了 这 
一 状况 ， 但 由 于 该 书 的 某 些 部 分 与 国内 的 现状 有 些 脱 离 ， 且 翻译 速度 
无 法 跟 上 原版 的 更 新 速度 ， 于 是 笔者 编写 本 书 ， 目 的 也 是 帮助 大 家 理 
解 和 使 用 Maven ° 
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能 大 致 了 解 Maven 是 什么 ， 以 及 它 有 什么 用 途 。 我 们 还 将 Maven 与 其 
他 流行 的 构建 工具 (如 Make 和 Ant) 做 了 一 些 比较 和 分 析 。 如 果 你 没 
用 过 Maven， 但 有 Make 或 者 Ant 的 使 用 经 验 ， 相 信 通 过 比较 你 能 更 清 
楚 地 了 解 各 种 工具 的 优 务 ， 并 且 会 对 Maven 有 一 个 理性 的 认识 。 


将 Maven 和 极限 编程 结合 起 来 分 析 是 为 了 让 大 家 从 另 一 个 角度 了 
解 Maven， 毕 竟 软 件 开发 离 不 开 对 于 软件 过 程 的 理解 。 


本 章 最 后 还 收集 了 一 些 用 户 对 Maven 的 误解 ， 并 逐条 进行 了 分 析 
和 解释， 希望 能 够 消除 大 家 的 误解 ， 从 而 积极 地 接受 Maven， 最 终 从 
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第 2 瘟 ”“Maven 的 安装 和 配置 


.在 Windows 上 安装 Maven 


.在 基于 UNIX 的 系统 上 安装 Maven 


设置 HTTP 代 理 
:安装 m2eslipse 


.安装 NetBeans Mavens (+ 


第 1 草 介 绍 了 Maven 是 什么 ， 以 及 为 什么 要 使 用 Maven， 我 们 将 从 
本 章 开始 实 际 接触 Maven。 本 章 首 移 将 介绍 如 何在 主流 的 操作 系统 
安 疾 Maven， 并 详细 解释 Maven 的 安装 文件 ， 其 次 还 会 介绍 如 何在 主 
流 的 IDE 中 集成 Maven， 以 及 Maven 安 闭 的 最 佳 实践 。 


2.1 在 Windows 上 安装 Maven 


2.1.1 JAEK E 


在 安装 Maven 之 前 ， 首 先 要 确认 你 已 经 正确 安装 了 JDK。Maven 可 
以 运行 在 JDK 1.4 及 以 上 的 版 本 上 。 本 书 的 所 有 样 例 都 基于 JDK 5 及 以 
上 版 本 。 打 开 Windows 的 命令 行 ， 运 行 如 下 的 命令 来 检查 Java 安 装 : 


结果 如 图 2-1 所 示 : 


>: Wsers\Juven Rudecho ~JAUA_HOMEZ 
D: \java\jdki .6.6@_8@7 


D: WsersWuven Ku>java -version 


java version "1.6.0 _07" 
avaCTIM)> SE Runtime Environment Cbuild 1.6.6_87-—b06> 
ava HotSpot TIM> Client UM Cbhuild 16.@-b23. mixed mode. sharing? 


图 2-1 Windows 中 检查 Java 安 装 


上 述 命 令 首 先 检查 环境 变量 JAVA_ HOME 是 否 指 向 了 正确 的 JDK 目 
录 ， 接 着 党 试 运行 java 命 令 。 如 果 Windows 无 法 执行 java 命 令 ， 或 者 无 
法 找到 JAVA_HOME 环 境 变 量 ， 束 需要 检查 Java 是 否 安装 了 ， 或 者 环境 


变量 是 否 设置 正确 。 关 于 环境 变量 的 设置 ， 请 参考 2.1.3-。 


2.1.2 下载 Maven 


请 访问 Maven 的 下 载 页 面 : 
http://maven.apache.org/download.html， 其 中 包含 针对 不 同 平台 的 各 种 
版 本 的 Maven 下 载 文件 。 对 于 首次 接触 Maven 的 读者 来 说 ， 推 荐 使 用 
Maven 3.0， 因 此 需要 下 载 apache-maven-3.0-bin.zip。 当 然 ， 如 果 你 对 
Maven 的 源 代 码 感 兴 趣 并 想 上 自己 构建 Maven， 还 可 以 下 载 apache- 
maven-3.0-src.zip。 该 下 载 页 面 还 提供 了 md5 校 验 和 (checksum) 文件 
和 asc 数 字 签 名 文件 ， 可 以 用 来 检验 Maven 分 发 包 的 正确 性 和 安全 性 。 


在 编写 本 书 的 时 候 ，Maven 2 的 最 新 版 本 是 2.2.1，Maven 3 基本 完 
全 兼容 Maven 2， 而 且 比 Maven 2 的 性 能 更 好 ， 还 对 其 中 某 些 功能 进行 
了 改进 。 如 果 你 之 前 一 直 使 用 Maven 2， 现 在 正 犹豫 是 否 要 升级 ， 那 就 
大 可 不 必 担 心 了 ， 快 点 尝试 一 下 Maven 3 吧 |! 


2.1.3 ”本 地 安装 


将 安装 文件 解压 到 指定 的 目 永 中 ， 如 : 


D:\bin>jar xvf "C:\Users \Juven Ku \Downloads \apache-maven-3.0 bin.zip" 


这 里 的 Maven 安 装 上 日 录 是 D: \bin\apache-maven-3.0， 接 着 需要 设置 
环境 变量 ， 将 Maven 安 装配 置 到 操作 系统 环境 中 。 


打开 系统 属性 面板 《在 桌面 上 右 击 “ 我 的 电脑 ”~ “属性 2 ， 单 击 高 
级 系统 设置 ， 再 单 击 环境 变量 ， 在 系统 变量 中 新 建 一 个 变量 ， 变 量 名 
为 M2_HOME， 变 量 值 为 Maven 的 安装 目录 D: \bin\apache-maven-3.0 ° 
单 击 “ 确 定 ” 按 钮 ， 接 着 在 系统 变量 中 找到 一 个 名 为 Path 的 变量 ， 在 变量 
值 的 末尾 加 上 %M2_HOME%\bin; 。 注 意 : 多 个 值 之 间 需 要 有 分 号 隔 
开 ， 然 后 单 击 “确定 按钮。 至 此 ， 环 境 变 量 设置 完成 。 详 细 情 况 如 图 2- 
2PTAN ° 


Path 


sion: XJAVA_HOMES\bin: SM2_HOMES\ bin: % 


arpa =: 6 
ze 值 


Path C:\Windows \system32;C: \Windows;.. | 
PATHEXT COM; EXE;.BAT;.CMD;. VBS; VBE:.... | 


PROCESSOR_AR... x86 
PROCESSOR_ID... x86 Family 6 Model 15 Stepping . - 


we || 取消 | 


图 2-2” Windows 中 系统 环境 变量 配置 


值得 注意 的 是 Path 环 境 变量 。 当 我 们 在 cmd 中 输入 命令 时 ， 
Windows 首 先 会 在 当前 目录 中 寻找 可 执行 文件 或 脚本 ， 如 果 没 有 找到 ， 
Windows 会 接着 遍历 环境 变量 Path 中 定义 的 路 径 。 由 于 
将 %M2_HOME%\bin 添 加 到 了 Path 中 ， 而 这 里 %M2_HOME% 实 际 上 是 
引用 了 前 面 定 义 的 男 一 个 变量 ， 其 值 是 Maven 的 安装 目录 。 因 此 ， 


Windows 会 在 执行 命令 时 搜索 日 隶 D: \bin\apache-maven-3.0\bin, M 
mvn 执 行 脚本 的 位 置 就 是 这 里 。 


了 解 环境 变量 的 作用 之 后 ， 现 在 打开 一 个 新 的 cmd 窗 口 (这 里 强调 
新 的 窗口 是 因为 狐 的 环境 变量 配置 需要 新 的 cmd 窗 口才 能 生效 ) ， 运 行 


如 下 命令 检查 Maven 的 安装 情况 : 


m 


s \Juven Xu > echo % M2_HOME% 
C: Users \Juven Xu >mvn-v 


运行 结 末 如 图 2-3 所 示 。 


D:N>echo ZMH2_HOMEZ 
D: \bin \apac he—maven—3 .@ 


D=\>mun -u 

Apache Maven 3.6 ¢r996166; 2616-89-11 17:32:16+8868)> 
Java version: 1.6.6_67 

Java home: D:\java\jdki.6.6_67\jre 

Default locale: zh_CN. platform encoding: GBi8636 


: “windows uista" version: "6_@" arch: "x86" Family: “windows" 


图 2-3 ”Windows 中 检查 Maven 安 装 


第 一 条 命令 echo%M2_HOME% 用 来 检查 环境 变量 M2_HOME 是 否 
指向 了 正确 的 Maven 安 装 目录 ; 而 mvn-v 执 行 了 第 一 条 Maven 命 令 ， 以 
检查 Windows 是 否 能 够 找到 正确 的 mvn 执 行 脚 本 。 


2.1.4 升级 Maven 


Maven 更 新 比较 频繁 ， 因 此 用 户 往 往 会 需要 更 新 Maven 安 装 以 获 
得 更 多 、 更 酷 的 新 特性 ， 并 避免 一 些 旧 的 bug 。 


在 Windows 上 更 新 Maven 非 常 简 便 ， 只 需要 下 载 新 的 Maven 安 装 文 
件 ， 解 压 至 本 地 目录 ， 然 后 更 新 M2_HOME 环 境 变量 即 可 。 例 如 ， 假 
设 Maven 推 出 了 新 版 本 3.1， 我 们 将 其 下 载 然后 解压 至 目录 D: 
\binvapache-maven-3.1， 接 着 遵照 前 一 节 描 述 的 步骤 编辑 环境 变量 
M2_HOME， 更 改 其 值 为 D; \bin\apache-maven-3.1。 至 此 ， 更 新 就 完 
成 了 。 同 理 ， 如 果 需 要 使 用 某 一 个 旧版 本 的 Maven， 也 只 需要 编辑 
M2_HOME 环 境 变 量 指 向 旧版 本 的 安 效 目录 。 


2.2 ”在 基于 UNIX 的 系统 上 安装 Maven 


Maven 是 跨 平 台 的 ， 它 可 以 在 任何 一 种 主流 的 操作 系统 上 运行 。 
本 节 将 介绍 如 何在 基于 UNIX 的 系统 (包括 Linux、Mac OS 以 及 
FreeBSD 等 ) 上 安装 Maven。 


2.2.1 下 载 和 安装 


首先 ， 与 在 Windows 上 安装 Maven 一 样 ， 需 要 检查 JAVA_HOME 环 
境 变 量 以 及 Java 命 令 ， 这 里 对 细节 不 再 长 述 。 命 令 如 下 : 
juven@ juven-ubuntu: ~ $ echo $ JAVA_HOME 


juven@ juven-ubuntu: ~ $ java-version 


运行 结果 如 图 2-4 所 示 。 


juven@juven-ubuntu:~$ echo $JAVA HOME 
/usr/local/jdk1.6.6 11 
juven@juven-ubuntu:~$ java -version 


java version "1.6.0 11” 
Java(TM) SE Runtime Environment (build 1.6.0 11-b03) 
Java HotSpot(TM) Server VM (build 11.0-b16, mixed mode) 


图 2-4 Linux 中 检查 Java 安 装 


接着 到 http://maven.apache.org/download.html 下 载 Maven 安 装 文件 ， 
如 apache-maven-3.0-bin.tar.gz， 然 后 解压 到 本 地 目录 : 


现在 已 经 创建 好 了 一 个 Maven 安 装 目 孙 apache-maven-3.0。 虽 然 直 
接 使 用 该 目 永 配置 环境 变量 之 后 驶 能 使 用 Maven 了 ， 但 这 里 的 推荐 做 法 
是 ， 在 安装 目 孙 旁 平行 地 创建 一 个 符号 链接 ， 以 方便 日 后 的 升级 : 


接 下 来 ， 需 要 设置 M2_HOME 环 境 变 量 指向 符号 链接 apache- 
maven-， 并 且 把 Maven 安 闭 目 孙 下 的 bin/ 文 件 夹 添加 到 系统 环境 变量 
PATH 中 


一 般 来 说 ， 需 要 将 这 两 行 命令 加 入 到 系统 的 登录 shell 脚 本 中 去 ， 
以 Ubuntu 8.10 为 例 ， 编 辑 ~/.bashrc 文 件 ， 添 加 这 两 行 命 令 。 这 样 ， 每 次 


局 动 一 个 终端 ， 这 些 配 置 束 能 目 动 执行 。 


至 此 ， 安 装 完成 。 可 以 运行 以 下 命令 检查 Maven 安 装 : 


图 2-5 ” Linux 中 检查 Maven 安 装 


2.2.2 FF% Maven 


在 基于 UNIX 的 系统 上 ， 可 以 利用 符号 链接 这 具 来 简化 Maven 
的 升级 ， 不 必 像 在 Windows 上 那样 ， 每 次 升级 都 必须 更 新 环境 变量 。 


前 一 小 节 中 我 们 提 到 ， 解 压 Maven 安 装 包 到 本 地 之 后 ， 平 行 地 创建 
一 个 符号 链接 ， 然 后 在 配置 环境 变量 时 引用 该 符号 链接 ， 这 样 做 是 为 
了 方便 升级 。 现 在 ,假设 需要 升级 到 新 的 Maven 3.1 版 本 ， 将 安装 包 解 
压 到 与 前 一 版 本 平行 的 目录 下， 然后 更 新 符号 链接 指向 3.1 版 的 目录 便 


iven@ juven-ubuntu:bin $ rm apache-maven 

iven@ juven-ubuntu:bin $ ln-s apache-maven-3.1/apache-maven 

juven@ juven- ntu:bin $ 1s-] 
total 8 

rwxrwxrwx 1 juven juven 17 2009 -09 -20 16:13 apache-maven -> apache-maven-3.1/ 


€ I 
drwxr-xr-x 6 juven juven 4096 200 19 -09 -20 15:39 saat, ea aven-3.0 
€ 


drwxr-xr-x 2 juven juven 4096 2009 -09 -20 16:09 apache-maven-3.1 


同 理 ， 可 以 很 方便 地 切换 到 Maven 的 任意 一 个 版 本 。 现 在 升级 完成 


了 ， 可 以 运行 nvn-v 进 行 检查 。 


2.3 KARA RAT 


前 面 讲述 了 如 何在 各 种 操作 系统 中 安装 和 升级 Maven。 现 在 来 仔 
细 分 析 一 下 Maven 的 安装 文件 。 


2.3.1 M2 HOME 


前 面 讲 到 设置 M2_HOME 环 境 变量 指向 Maven 的 安装 目 孙 ， 本 书 
之 后 所 有 使 用 M2_HOME 的 地 方 都 指 代 了 该 安装 目录 。 下 面 看 一 下 该 
目录 的 结构 和 内 容 : 


bin: 该 目录 包含 了 mvn 运 行 的 脚本 ， 这 些 脚 本 用 来 配置 Java 命 
令 ， 准 备 好 classpath 和 相关 的 Java 系 统 属性 ， 然 后 执行 Java 命 令 。 其 中 
mvn 是 基于 UNIX 平 台 的 shell 脚 本 ，mvn.bat 是 基于 Windows 平 台 的 bat 脚 
本 。 在 命令 行 输入 任何 一 条 mvn 命 令 时 ， 实 际 上 就 是 在 调用 这 些 脚 
本 。 该 目录 还 包含 了 mvnDebug 和 mvnDebug.bat 两 个 文件 ， 同 样 ， 前 者 
是 UNIX 平 台 的 shell 脚 本 ， 后 者 是 windows 平 台 的 bat 脚 本 。 那 么 mvn 和 
mvnDebug 有 什么 区 别 和 关系 呢 ? 打 开 文 件 我 们 就 可 以 看 到 ， 两 者 基本 
是 一 样 的 ， 只 是 mvnDebug 多 了 一 条 MAVEN_DEBUG_OPTS 配 置 ， 其 
作用 就 是 在 运行 Maven 时 开启 debug， 以 便 调试 Maven 本 身 。 此 外 ， 该 
目录 还 包含 m2.conf 文 件 ， 这 是 classworlds 的 配置 文件 ， 后 面 会 介绍 


classworlds ° 


‘boot: 该 目录 只 包含 一 个 文件 ， 以 maven 3.0 为 例 ， 该 文件 为 
plexus-classworlds-2.2.3.jar。plexus-classworlds 是 一 个 类 加 载 絮 框架 ， 
相对 于 默认 的 java 类 加 载 器 ， 它 提供 了 更 丰富 的 语法 以 方便 配置 ， 
Maven 使 用 该 框架 加 载 目 己 的 类 库 。 更 多 天 于 classworlds 的 信息 请 参考 
http:/classworlds.codehaus.org/。 对 于 一 般 的 Maven 用 户 来 说 ， 不 必 关 
心 该 文件 。 


‘conf: 该 目录 包含 了 一 个 非常 重要 的 文件 settings.xml。 直 接 修 改 
该 文件 ， 就 能 在 机 器 上 全 局 地 定制 Maven 的 行为 。 一 般 情 况 下 ， 我 们 
更 偏向 于 复制 该 文件 至 ~/.m2/ 目 录 下 (~ 表示 用 户 目录 ) ， 然 后 修改 该 
文件 ， 在 用 户 范 围 定 制 Maven 的 行为 。 后 面 将 会 多 次 提 到 
settings.xml， 并 逐步 分 析 其 中 的 各 个 元 素 。 


‘lib: 该 目录 包含 了 所 有 Maven 运 行 时 需要 的 Java 类 库 ，Maven 本 
号 是 分 模块 开发 的 ， 因 此 用 户 能 看 到 诸如 maven-core-3.0.jar、maven- 
model-3.0.jar 之 类 的 文件 。 此 外 ， 这 里 还 包含 一 些 Maven 用 到 的 第 三 方 
依赖 ， 如 common-cli-1.2.jar、google-collection-1.0.jar 等 。 对 于 Maven 2 
来 说 ， 该 目录 只 包含 一 个 如 maven-2.2.1-uber.jar 的 文件 ， 原 本 各 为 独立 
JAR 文 件 的 Maven 模 块 和 第 三 方 类 库 都 被 拆 解 后 重新 合并 到 了 这 个 JAR 
文件 中 。 可 以 说 ，]lib 目 录 就 是 真正 的 Maven。 关 于 该 文件 ， 还 有 一 点 
值得 一 提 的 是 ， 用 户 可 以 在 这 个 目录 中 找到 Maven 内 置 的 超级 POM ， 
这 一 点 在 8.5 节 详细 解释 。 其 他 : LICENSE.txt 记 录 了 Maven 使 用 的 软件 


许可 证 Apache License Version 2.0; NOTICE.txt 记 录 了 Maven 包 含 的 第 


三 方 软件 ， 而 README.txt 则 包含 了 Maven 的 简要 介绍 ， 包 括 安 : 


及 如 何 安 厄 的 简要 指令 等 。 


2.32 OUI 


在 讲述 该 小 节 之 前 ， 我 们 先 运行 一 条 简单 的 命令 : mv help: 
system。 该 命令 会 打印 出 所 有 的 Java 系 统 属性 和 环境 变量 ， 这 些 信息 
对 我 们 日 第 的 编程 工作 很 有 帮助 。 这 里 和 暂 不 解释 help: system 涉 及 的 语 
法 ， 运 行 这 条 命令 的 目的 是 让 Maven 执 行 一 个 真正 的 任务 。 我 们 可 以 
从 命令 行 输 出 看 到 Maven 会 下载 maven-help-plugin， 包 括 pom 文 件 和 jar 
文件 。 这 些 文件 都 被 下 载 到 了 Maven 本 地 仓库 中 。 


现在 打开 用 户 目录 ， 比 如 当前 的 用 户 目录 是 C: \UsersJuven 
Xu\， 你 可 以 在 Vista 和 Windows7 中 找到 类 似 的 用 户 目 录 。 如 果 是 更 早 
版 本 的 Windows， 该 目录 应 该 类 似 于 C: \Document and Settings\Juven 
Xu\。 在 基于 UNIX 的 系统 上 ， 直 接 输 入 cd 回 车 ， 就 可 以 转 到 用 户 目 
录 。 为 了 方便 ， 本 书 统一 使 用 符号 ~ 指 代 用 户 目录 。 


在 用 户 目 录 下 可 以 发 现 .m2 文件 来 。 上 默认 情况 下 ， 该 文件 夹 下 放置 
了 Maven 本 地 仓库 .m2/repository。 有 所 有 的 Maven 构 件 都 被 存储 到 该 仓库 
中 ， 以 方便 重用 。 可 以 到 
~/.m2/repository/org/apache/maven/plugins/maven-help-plugins/ 目 录 下 找 
到 刚才 下载 的 maven-help-plugin 的 pom 文 件 和 jar 文 件 。Maven 根 据 一 套 
规则 来 确定 任何 一 个 构件 在 仓库 中 的 位 置 ， 这 一 点 在 第 6 革 将 会 评 细 并 


述 。 由 于 Maven 仓 库 是 通过 简单 文件 系统 透明 地 展示 给 Maven 用 户 
的 ， 有 些 时 候 可 以 绕 过 Maven 直 接 查 看 或 修改 仓库 文件 ， 在 过 到 疑难 
问题 时 ， 这 往往 十 分 有 用 。 


默认 情况 下 ，~/.m2 目 录 下 除了 repository 仓 库 之 外 就 没有 其 他 目录 
和 文件 了 ， 不 过 大 多 数 Maven 用 户 需 要 复制 
M2_HOME/conf/settings.xml 文 件 到 ~/.m2/settings.xml。 这 是 一 条 最 佳 实 
践 ， 我 们 将 在 2.7 小 节 详 细 解 释 。 


2.4 设置 HTTP 代 理 


有 时 候 你 所 在 的 公司 基于 安全 因素 考虑 ， 要 求 你 使 用 通过 安全 认 
证 的 代理 访问 因特网 。 这 种 情况 下 ， 就 需要 为 Maven 配 置 HTTP 代 理 ， 
才能 让 它 正 常 访问 外 部 仓库 ， 以 下 载 所 需要 的 资源 


首先 确认 自己 无 法 直接 访问 公共 的 Maven 中 央 人 仓库， 直接 运行 命令 
ping repo1.maven.org 可 以 检查 网 络 。 如 果真 的 需要 代理 ， 先 检查 一 下 代 
理 服务 器 是 否 畅 通 。 比 如 现在 有 一 个 IP 地 址 为 218.14.227.197， 端 口 为 
3128 的 代理 服务 ， 我 们 可 以 运行 telnet 218.14.227.1973128 来 检测 该 地 址 
的 该 端口 是 否 畅通 。 如 果 得 到 出 错 信息 ， 需 要 先 获取 正确 的 代理 服务 
信息 如果 telnet 连 接 正确 ， 则 输入 ctrl+|] ， 然 后 g， 回 车 ， 退 出 即 可 。 


仿 查 完毕 之 后 ， 编 辑 ~/.m2/settings.xml 文 件 (如 果 没 有 该 文件 ， 则 
复制 $M2_HOME/conf/settings.xml) 。 添 加 代理 配置 如 下 : 


oxiles > 
<pr 
<j ly -proxy < Ad 
t true < /active 
http < > 
4.227 st 
3 < / por 
use ar x 家 * username 
passu d>* * 本 asswora 
<nonProxyHosts > repository. mycom. com |* .qoogle. com< MonProxyHosts > 
< /PIroxy 
proxies 
ettings 


这 上 段 配 置 十 分 简单，proxies 下 可 以 有 多 个 proxy 元 素 ， 如 果 声 明了 
多 个 proxy 元 素 ， 则 默认 情况 下 第 一 个 被 激活 的 proxy 会 生效 。 这 里 声明 
了 一 个 id 为 my-proxy 的 代理 ，active 的 值 为 true 表 示 激 活该 代理 ， 
protocol 表 示 使 用 的 代理 协议 ， 这 里 是 http。 当 然 ， 最 重要 的 是 指定 下 
确 的 主机 名 (host 元 素 ) 和 端口 (port 元 素 ) 。 上 述 XML 配 置 中 注释 掉 
了 username、password、nonProxyHost 儿 个 元 素 。 当 代理 服务 需要 认证 
时 ， 就 需要 配置 username 和 password。nonProxyHost 元 素 用 来 指定 哪些 
主机 名 不 需要 代理 ， 可 以 使 用 “符号 来 分 隔 多 个 主机 名。 此 外 ， 该 配 
置 也 文 持 通配符 ， 如 *.google.com 表 示 所 有 以 google.com 结 尾 的 域名 访 
问 都 不 要 通过 代理 。 


2.5 #m2eclipse 


Eclipse 是 一 款 非常 优秀 的 IDE。 除 了 基本 的 语法 标 亮 、 代 码 补 齐 、 
XML 编 辑 等 基本 功能 外 ， 最 新 版 的 Eclipse 还 能 很 好 地 支持 重 构 ， 并 且 
集成 了 JUnit、CVS、Mylyn 等 各 种 流行 工具 。 可 惜 Eclipse 默 认 没有 集成 
对 Maven 的 文 持 。 科 运 的 是 ， 由 Maven 之 父 Jason Van Zyl 创立 的 
Sonatype 公 司 建立 了 m2eclipse 项 目 。 这 是 Eclipse 下 的 一 款 十 分 强大 的 
Maven 插 件 ， 可 以 访 间 http://m2eclipse.sonatype.org/ 了解 更 多 该 项 目的 信 
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m2eclipse 插 件 的 使 用 。 


现在 以 Eclipse 3.6 为 例 逐 步 讲 解 m2eclipse 的 安装 。 启 动 Eclipse 之 
后 ， 在 菜单 栏 中 选择 Help， 然 后 选择 Install New Software...， 接 着 你 会 
看 到 一 个 Install 对 话 框 。 单 击 Work with: 字段 边 上 的 Add 按 钮 ， 会 弹出 
一 个 新 的 Add Repository 对 话 框 。 在 Name 字 段 中 输入 m2e， 在 Location 
字段 中 输入 http://m2eclipse.sonatype.org/sites/m2e， 然 后 单 击 OK 按钮 。 
Eclipse 会 下 载 m2eclipse 安 装 站 点 上 的 资源 信息 。 等 待 资源 载 入 完成 之 
后 ， 再 将 其 全 部 展开 ， 就 能 看 到 图 2-6 所 示 的 界面 。 


= install 


Available Software 


Check the items that you wish to Install. 


Work with: m2e - http://m2eclipsesonatype.org/sites/m2e 
Find more software by working with the -Available Software Sites" preferences. 


type filter text 


| Name Version 
| a M Ul Maven Integration for Eclipse 
| E $> Maven Integration for Eclipse (Required) 0.10,2.20100623-1649 


| Deselect All | 


Details 


网 Show only the latest versions of available software [F] Hide items that are already installed 
[7] Group items by category What is already installed? 
[F] Contact all update sites during install to find required software 


®© 


图 2-6 ”m2eclipse 的 核心 安装 资源 列表 


图 2-6 显 示 了 m2eclipse 的 核心 模块 Maven Integration for Eclipse 
(Required) ， 选 择 后 单 击 Next 按 钮 ，Eclipse 会 自动 计算 模块 间 依赖 ， 
然后 给 出 一 个 将 被 安装 的 模块 列表 。 确 认 无 误 后 ， 继 续 单 击 Next 按 


这 时 会 看 到 许可 证 信息 。m2eclipse 使 用 的 开源 许可 证 是 Eclipse 
Public License v1.0， 选 择 I accept the terms of the license agreements, $A 
后 单 击 Finish 按 钮 ， 接 着 就 春心 等 待 Eclipse 下 载 安装 这 些 模块 ， 如 图 2-7 
所 示 ° 


S installing Software 


0 Installing Software 


Fetching org.maven.ide.eclipse.pr_0.10.2.2...n.ide.eclipse.pr_0.10.2.20100623-1649.jar 


| Always run in background 


[Run in Background | | Cancel | l Details >> 


图 2-7 m2edlipse 安 装 进度 


除了 核心 组 件 之 外 ，m2eclipse 还 提供 了 一 组 额外 组 件 ， 主 要 是 为 
了 方便 与 其 他 工具 如 Subversion 进 行 集成 ， 这 些 组 件 的 安装 地 址 为 
http://m2eclipse.sonatype.org/sites/m2e-extras。 使 用 前 面 类 似 的 安装 方 
法 ， 可 以 看 到 图 2-8 所 示 的 组 件 列 表 。 


下 面 简 单 解释 一 下 这 些 组 件 的 用 途 


1. 重 要 的 


-Maven SCM handler for Subclipse (Optional) : Subversion 是 非常 
流行 的 版 本 管理 工具 。 该 模块 能 够 帮助 我 们 直接 从 Subversion 服 务 器 俭 
出 Maven 项 目 ， 不 过 前 提 是 需要 首先 安装 Subclipse 


(http://subclipse.tigris.org/) ° 


EN 


-Maven SCM Integration (Optional) : Eclipse 环境 中 Maven 与 SCM 
集成 核心 的 模块 。 它 利用 各 种 SCM 工 具 如 SVN 实 现 Maven 项 目的 签 出 
和 具体 化 等 操作 。 


2. 不 重要 的 


-Maven issue tracking configurator for Mylyn 3.x (Optional) : 该 模 


块 能 够 帮助 我 们 使 用 POM 中 的 缺陷 跟 躁 系统 信息 连接 Mylyn 人 至 服务 器 。 


-Maven SCM handler for Team/CVS (Optional) : 该 模块 帮助 我 们 
从 CVS 服 务 器 签 出 Maven 项 目 ， 如 果 还 在 使 用 CVS， 就 需要 安装 它 。 


-Maven Integration for WTP (Optional) : 使 用 该 模块 可 以 让 Eclipse 
目 动 读 取 POM 信 息 并 配置 WTP 项 目 。 


.M2Eclipse Extensions Development Support (Optional) : 用 来 支持 
扩展 m2eclipse， 一 般 用 户 不 会 用 到 。 


@ Install 


Available Software 
Check the items that you wish to install. 


Work with: m2e-extras - http://m2eclipse.sonatype.org/sites/m2e-extras X 
Find more software by working with the “Available Software Sites” p 
type filter text 


Name Version 

a [| WI Maven Integration for Eclipse Extras 
同 4p M2Eclipse Extensions Development Support (Optional) 0.10.0.20100209-0800 
IF QL Maven Integration for WTP (Optional) 0.10.0.20100209-0800 
加 @ Maven issue tracking configurator for Mylyn 3.x (Optional) 0.10.0.20100209-0200 
E @& Maven SCM handler for Subclipse (Optional) 0.10.0,20100209-0800 
[E 只 Maven SCM handler for Team/CVS (Optional) 0.10.0.20100209-0800 
[E @ Maven SCM Integration (Optional) 0.10.0,20100209-0800 
加 Project configurators for commonly used maven plugins (temporary) _0.10.0.20100209-0200 


Select all 


Details 
Checkout projects using Maven SCM providers 


|] Show only the latest versions of available software [E Hide items that are already installed 
| E] Group items by category What is already installed? 
[7] Contact all update sites during install to find required software 


@ 


图 2-8 ”m2edlipse 的 额外 组 件 安装 资源 列表 


‘Project configurators for commonly used maven plugins 
(temporary) : 一 个 临时 的 组 件 ， 用 来 文 持 一 些 Maven 插 件 与 Eclipse 的 
集成 ， 建 议 安装 。 


读者 可 以 根据 目 己 的 需要 安 故 相应 组 件 ， 具 体 步 又 这 里 不 再 性 


yli o 


符 安 装 完毕 后 ， 重 局 Eclipse。 现 在 来 验证 一 下 m2eclipse 是 否 正 确 
安装 了 。 首 先 ， 单 击 菜单 栏 中 的 Help， 然 后 选择 About Eclipse。 在 弹出 
的 对 话 框 中 ， 单 击 Installation Details 按 钮 ， 会 得 到 一 个 对 话 框 。 在 
Installed Software 标 签 中 ， 检 查 刚才 选择 的 模块 是 否 在 这 个 列表 中 ， 如 
图 2-9 所 示 。 


如 果 一 切 没 问 题 ， 再 检查 一 下 Eclipse 现在 是 否 已 经 支持 创建 Maven 
项 目 。 依 次 单 击 某 单 栏 中 的 File New 一 Other， 在 弹出 的 对 话 框 中 ， 找 
到 Maven 一 项 ， 再 将 其 展开 ， 应 该 能 够 看 到 图 2-10 所 示 的 对 话 框 。 


如 果 一 切 正常 ， 说 明 m2eclipse 已 经 正确 安装 了 


最 后 ， 关 于 m2eclipse 的 安装 需要 提醒 的 一 点 是 ， 你 可 能 会 在 使 用 
m2eclipse 时 遇 到 类 似 这 样 的 钳 误 ; 


Name Id 
i CollabNet Merge Client 2.1.0 com.collabnet.subversion.merge.featu... 

> WB Eclipse IDE for Java Developers 1.3.0.20100617-0... epp.package,java 
(gi JNA Library 3.2.3 com.sun,jna.feature.group 

b WY Maven Integration for Eclipse (Required) 0,10.2.20100623-... org.maven.ide.eclipse.feature.feature.... 
{i Maven SCM handler for Subclipse (Optional) 0.10,0.20100209-..._ org.maven,ide.eclipse.subclipse.featur... 
{gi Maven SCM Integration (Optional) 0.10,0.20100209-... org.maven.ide.eclipse.scm.feature. feat... 
{i Project configurators for commonly used maven plugit 0.10.0.20100209-... org.maven.ide.eclipse.temporary.mojo... 
G Subclipse (Required) 1.6.13 org.tigris.subversion.subclipse.feature.... 
{2 Subclipse Integration for Mylyn 3.x (Optional) org.tigris.subversion.subclipse.mylyn.f... 


号 Subversion Client Adapter (Required) org.tigris.subversion.clientadapter. feat... 
G Subversion JavaHL Native Library Adapter (Required) org.tigris.subversion.clientadapter jav... 

外 Subversion Revision Graph org.tigris.subversion.subclipse.graph.t... 
G SVNKit Client Adapter (Not required) org.tigris.subversion.clientadapter.svn... 
Q SVNKit Library 1.3.3.6648 org.tmatesoft.svnkit.feature.group 


Maven integration. Launching Maven from Eclipse, dependency management and search. 


图 2-9_m2eclipse 安 装 结 


Select a wizard 
Create a Maven Project 


Wizards: 
type filter text 


& General 

@ Cvs 

© Java 

& Maven 
EI Checkout Maven Projects from SCM 
M Maven Module 
i? Maven POM file 
Ms Maven Project 

EE SVN 

@ Tasks 

XML 

& Examples 


图 2-10 Eclipse F ĝl] Maven H P = 


09 -10 -6 E+ 01 A¢ 14 49 秒 : Eclipse is running in a JRE, but a JDK is required 
Some Maven plugins may not work when importing projects or updating source fold- 
ers. 


这 是 因为 Eclipse 默认 是 运行 在 了 RE 上 的 ， 而 m2eclipse 的 一 些 功能 
求 使 用 JDK 。 解 决 方法 是 配置 Eclipse 安装 目录 的 eclipse.ini 文 件 ， 添 加 
vm 配置 指向 JDK。 例 如 : 


— launcher. XXMaxPermSize 
256m 


-vm 
D:\java \jdk1.6.0_07 \bin\javaw. exe 
—vmargs 


-Dosgi. requiredJavaVersion =1.5 
一 Xms128m 


—Xmx256m 


2.6 安装 NetBeans Maven 插 件 


本 小 节 会 先 介 绍 如 何在 NetBeans 上 安装 Maven 搬 件 ， 后 面 的 章节 中 
还 会 介绍 NetBeans 中 具体 的 Maven 操 作 。 


如 果 正 在 使 用 NetBeans 6.7 及 以 上 版 本 ， 那 么 Maven 搬 件 已 经 预 装 
了 。 你 可 以 检查 Maven 插 件 安装 ， 单 击 菜单 栏 中 的 工具 ， 接 着 选择 插 
件 ， 在 弹出 的 插件 对 话 框 中 选择 已 安装 标签 ， 应 该 能 够 看 到 Maven 插 
件 ， 如 图 2-11 所 示 。 
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Java 
Java 持久 性 版 本 : 41.3 

Java Profiler YH: NetBeans IDE 6.7.1 (Build 200907230233) 
Spring Bean 
Ant 


Hibernate 插件 描述 
b =} -~ 


Netbeans 


回回 回回 回回 % 


NetBeans IDE 支持 Apache Maveno 


Maven 是 一 个 软件 项 目 管理 和 理解 工具 。 基 于 项 目 对 象 模块 (POM) 
LS» Maven 能 管理 项 目 生 成 ， 以 及 来 自 中 心 片 信息 的 报告 和 文档 。 
想 学 习 到 更 多 有 关 Apache Maven， 请 访问 Maven 是 什么 ? 页 面 。 


IDE 完全 支持 基于 Maven 的 medatata 世 括 自身 项 目 类 型 ， Haven 
项 目 文件 代码 完成 , 在 IDE 中 集成 其 它 工 县 等 。 


ae 


GUI 生成 器 Java SE 
Java iit Java SE 
RCP 平台 RCP 平台 
服务 型 软件 Web 应 用 程序 
数据 库 基本 IDE 
Subver sion 基本 IDE 
Hudson 基本 IDE 
本 地 历史 记录 基本 IDE 
IDE 标记 基本 IDE 


— rnr. 
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图 2-11 已 安装 的 NetBeans Maven 插 件 


如 果 在 使 用 NetBeans 6.7 之 前 的 版 本 ， 或 者 由 于 某 些 原因 NetBeans 
Maven 插 件 被 外 载 了 ， 那 么 束 需 要 安装 NetBeans Maven 插 件 。 下 面 以 
NetBeans 6.1 为 例 ， 介 绍 Maven 插 件 的 安装 。 


同样 ， 单 击 菜 单 栏 中 的 工具 ， 选 择 插件 ， 在 弹出 的 插件 对 话 框 中 
选择 可 用 插件 标签 ， 接 着 在 右边 的 搜索 框 内 输入 Maven， 这 时 会 在 左边 
的 列表 中 看 到 一 个 名 为 Maven 的 插件 。 选 择 该 插件 ， 然 后 单 击 下 面 
的 “安装 ”按钮 ， 如 图 2-12 所 示 。 


可 用 插件 2/102 | 已 下 载 | Beet (20) | 设置 


重新 装 入 目录 R) 搜索 6S): maven 


NetBeans 认证 的 插件 


2 SES 
: The Codehaus 


括 件 描述 


NetBeans IDE support for _ apache. org’ >Apache Maven. 


Maven is a software project management and 
comprehension tool. Based on the concept of a project 
object model POM), Maven can manage a project s 


已 选择 1 插件 ，eMB 


图 2-12 ”安装 NetBeans Maven 插 件 


接着 在 随后 的 对 话 框 中 根据 提示 操作 ， 阅 读 相 关 许可 证 并 接受 ， 
NetBeans 会 自动 帮 有 我们 下 载 并 安装 Maven 揪 件 ， 结 束 之 后 会 提示 安装 完 
成 。 之 后 再 单 击 插件 对 话 框 中 的 已 安装 标签 ， 就 能 看 到 已 经 激活 的 
Maven 插 件 。 


最 后 ， 为 了 确认 Maven 插 件 确 实 已 经 正确 安装 了 ， 可 以 看 一 下 
NetBeans 征 否 已 经 拥有 创建 Maven 项 目的 相关 沫 单 。 在 全 单 栏 中 选择 文 
件 ， 然 后 选择 新 建 项 目 ， 这 时 应 该 能 够 看 到 项 目 类 别 中 有 Maven 一 项 。 
选择 该 类 别 ， 右 边 会 相应 地 显示 Maven 项 目 和 基于 现 有 POM 的 Maven 项 
目 ， 如 图 2-13 所 示 ° 


如 果 能 看 到 类 似 的 对 话 框 ， 说 明 NetBeans Maven 已 经 正确 安装 


| [D Java Maven 项 目 

-Q NetBeans 模块 基于 现 有 POM 的 Maven 项 目 
LB 

a epi 


Hai 0): 


使 用 Maven BAA) Archetype 括 件 创建 的 Maven2 项 目 模板 。 


图 2-13 ” NetBeans 中 创建 Maven 项 目 向 导 


2.7.1 设置 MAVEN _OPTS 环 境 变量 


前 面 介绍 Maven 安 装 目 录 时 我 们 了 解 到 ， 运 行 mvn 命 令 实际 上 是 
执行 了 Java 命 令 ， 既 然 是 运行 Java， 那 么 运行 Java 命 令 可 用 的 参数 当然 
也 应 该 在 运行 mvn 命 令 时 可 用 。 这 个 时 候 ，MAVEN_OPTS 环 境 变 量 就 
能 派 上 用 场 。 


通常 需要 设置 MAVEN_OPTS 的 值 为 -Xms128m-Xmx512m， 因 为 
Java 默 认 的 最 大 可 用 内 存 往往 不 能 够 满足 Maven 运 行 的 需要 ， 比 如 在 
项 目 较 大 时 ， 使 用 Maven 生 成 项 目 站 点 需要 占用 大 量 的 内 存 ， 如 果 没 
有 该 配置 ， 则 很 容易 得 到 java.lang.OutOfMemeoryError。 因 此 ， 一 开始 
就 配置 该 变量 是 推荐 的 做 法 。 


天 于 如 何 设置 环境 变量 ， 请 参考 前 面 设置 M2_HOME 环 境 变量 的 
做 法 ， 尽 量 不 要 直接 修改 mvn.bat 或 者 mvn 这 两 个 Maven 执 行 脚本 文 
件 。 因 为 如 果 修 改 了 脚本 文件 ， 升 级 Maven 时 就 不 得 不 再 次 修改 ， 一 
来 麻烦 ， 二 来 容易 忘记 。 同 理 ， 应 该 尽 可 能 地 不 去 修改 任何 Maven 安 
RARP 


2.7.2 ”配置 用 户 蕊 围 settings.xml 


Maven 用 户 可 以 选择 配置 $M2_HOME/conf/settings.xml 或 者 
~/.m2/settings.xml。 前 者 是 全 局 范围 的 ， 整 台 机 融 上 的 所 有 用 户 都 会 直 
接受 到 该 配置 的 影响 ， 而 后 者 是 用 户 范 围 的 ， 只 有 当前 用 户 才 会 受到 
该 配置 的 影响 。 


推荐 使 用 用 户 范 围 的 settings.xml， 主 要 是 为 了 避免 无 意识 地 影响 
到 系统 中 的 其 他 用 户 。 如 果 有 切实 的 需求 ， 需 要 统一 系统 中 所 有 用 户 
的 settings.xml 配 置 ， 当 然 应 该 使 用 全 局 范围 的 settings.xml ° 


除了 影响 范围 这 一 因素 ， 配 置 用 户 范 围 settings.xml 文 件 还 便于 
Maven 升 级 。 直 接 修改 conf 目 录 下 的 settings.xml 会 导致 Maven 升 级 不 
便 ， 每 次 升级 到 新 版 本 的 Maven， 都 需要 复制 settings.xml 文 件 。 如 果 
使 用 ~/.m2 目 录 下 的 settings.xml， 束 不 会 影响 到 Maven 安 装 文件 ， 升 级 
时 就 不 需要 触动 settings.xml 文 件 。 


2.7.3 7AN#(# AIDEW feAMaven 
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的 Maven， 这 个 内 骨 的 Maven 通 常会 比较 新 ， 但 不 一 定 很 稳定 ， 而 且 往 
往 也 会 和 在 命令 行使 用 的 Maven 不 是 同一 个 版 本 。 这 里 义 会 出 现 两 个 潜 
在 的 问题 : 首先 ， 较 新 版 本 的 Maven 存 在 很 多 不 稳定 因素 ， 容 易 造成 一 
些 难以 理解 的 问题 其次， 除了 IDE， 也 经 常 还 会 使 用 命令 行 的 
Maven， 如 果 版 本 不 一 致 ， 容 易 造 成 构建 行为 的 不 一 致 ， 这 是 我 们 所 不 
希望 看 到 的 。 因 此 ， 应 该 在 IDE 中 配置 Maven 皇 件 时 使 用 与 命令 行 一 致 
的 Maven 。 


在 m2eclipse 环 境 中 ， 单 击 菜 单 栏 中 的 Windows， 然 后 选择 
Preferences， 在 弹出 的 对 话 框 中 ， 展 开 左边 的 Maven 项 ， 选 择 
Installation 子 项 ， 在 右边 的 面板 中 ， 能 够 看 到 有 一 个 默认 的 Embedded 
Maven 安 装 被 选中 了 “。 单 击 Add... 按 钮 ， 然 后 选择 Maven 安 装 目录 
M2_HOME， 添 加 完毕 之 后 选择 这 一 个 外 部 的 Maven， 如 图 2-14 所 示 。 


Installations 


Select the installation used to launch maven: 


[F] Embedded (3.0-SNAPSHOT/0.10,0.20100209-08... 

Install/Update 回 Workspace (3.0) 
Java 回 External D:\bin\apache-maven-2.2.1 (2.2.1) 
Maven External D:\bin\apache-maven-3.0 (3.0) 

Archetypes 

Installations 

POM Editor 

Problem Reporting 


Templates Note: Embedded runtime is always used for dependency resolution, but 
User Settings does not use global settings when it is used to launch Maven. To learn 
Run/Debug more, visit the maven web page. 
Tasks 
Team 


Usage Data Collector 


Global settings from installation directory (open file): 


Validation D:\bin\apache-maven-3.0\conf\settings.xml 
XML 


图 2-14 在 Eclipse 中 使 用 外 部 Maven 


NetBeans Maven 插 件 默 认 会 侦 测 PATH 环境 变量 ， 因 此 会 直接 使 用 
与 命令 行 一 致 的 Maven 环 境 。 依 次 单 击 菜单 栏 中 的 工具 -选项 ~ 其 他 
”Maven 标 签 栏 ， 就 能 看 到 图 2-15 所 示 的 配置 。 


ad 总 
vu 


编辑 器 三 ) SAN) 快捷 键 映射 K) 


(嵌入 的 Maven 版 本 : 3. 0-SNAPSHOT ) 
DPB Maven Home BR: | 
使 用 缺 省 Maven 版 本 : 2.2.1 (位 于 PATH 环境 变量 中 ) 


全 Rh 和 Wo: | et) 
回 对 与 铀 区 没有 直接 关系 的 任何 生成 执行 跳 过 列 坏 G) 


SHARE L): 


项 目 打开 时 : 
下 载 二 进 制 文件 0): 
检查 Javadoc: 
检查 源 (5): 


图 2-15 ”在 NetBeans 中 使 用 外 部 Maven 


2.8 人 小结 


本 章 详细 介绍 了 在 各 种 操作 系统 平台 上 安装 Maven， 并 对 Maven 
安装 目录 进行 了 深入 的 分 机 ， 在 命令 行 的 基础 上 ， 又 进一步 介绍 了 
Maven 与 主流 IDE Eclipse 及 NetBeans 的 集成 。 本 章 最 后 还 介绍 了 一 些 与 
Maven 安 装 相 天 的 最 佳 实践 。 下 一 章 会 创建 一 个 Hello World, i 
领 读 者 配置 和 构建 Maven 项 目 。 


第 3 草 ”Maven 使 用 入 门 


:编写 POM 
编写 主 代码 


-编写 测试 代码 


{E Ħ Archetype Æ EI H F 2R 
.m2eclipse 人 简单 使 用 

-NetBeans Maven 插 件 简单 使 用 
.小结 


到 目前 为 目 ， 已 经 大 概 了 解 并 安装 好 了 Maven， 现 在 ， 我 们 开始 
创建 一 个 最 简单 的 Hello World 项 目 。 如 采 你 是 初次 接触 Maven， 建 议 
按照 本 章 的 内 容 一 步 步 地 编写 代码 并 执行 ， 其 中 可 能 你 会 僧 到 一 些 概 
念 暂 时 难以 理解 ， 不 用 着 急 ， 记 下 这 些 疑 难点 ， 相 信 本 书 的 后 续 章 节 


会 帮 你 逐一 解答 。 


3.1 编写 POM 


就 像 Make 的 Makefile、Ant 的 build.xml 一 样 ，Maven 项 目的 核心 是 
pom.xml。POM (Project Object Model， 项 目 对 象 模型 ) 定义 了 项 目的 
基本 信息 ， 用 于 描述 项 目 如 何 构建 ， 声 明 项 目 依 赖 ， 等 等 。 现 在 移 为 
Hello World 项 目 编写 一 个 最 简单 的 pom.xml ° 


首先 创建 一 个 名 为 hello-world 的 文件 夹 ， 打 开 该 文件 夹 ， 新 建 一 个 
名 为 pom.xml 的 文件 ， 输 入 其 内 容 ， 如 代码 清单 3-1 所 示 。 


代码 清单 3-1 Hello World 的 POM 


<?xml version a ae encod ng = "UTF -8 "?> 
<project xmlns http://maven. apache. org/POM/ in 0.0" 
xmins Si = "ht tp: // www. w3.org/2001 /XMLSchema-instance” 
chemaLocation = “http ; 


aven. apac he. org / PO 


1e. orc 1 - xsd" 
>4.0.0 < /modelVersion > 
>com. Juvenxu. mvnbook < /groupid > 
c<artifactid >hello-world < /artifactId> 
<version >1.0-SNAPSHOT < /version > 
<name >Maven Hello World Project < /name > 
foroject > 


代码 的 第 一 行 是 XML 头 ， 指 定 了 该 xm] 文 档 的 版 本 和 编码 方式 。 紧 
接着 是 project 元 素 ，project 是 所 有 pom.xml 的 根 元 素 ， 它 还 声明 了 一 些 
POM 相 关 的 命名 空间 及 xsd 元 隶 ， 虽 然 这 些 属 性 不 是 必须 的 ， 但 使 用 这 
些 属 性 能 够 让 第 三 方 工具 〈 如 IDE 中 的 XML 编辑 器 ) 帮助 我 们 快速 编 
辑 POM ° 


根 元 素 下 的 第 一 个 子 元 素 modelVersion 指 定 了 当前 POM 模 型 的 版 


本 ， 对 于 Maven 2 及 Maven 3 来 说 ， 它 只 能 是 4.0.0 ° 


这 段 代 码 中 最 重要 的 是 包含 groupId、artifactId 和 version 的 三 行 。 这 
三 个 元 素 定 义 了 一 个 项 目 基本 的 坐标 ， 在 Maven 的 世界 ， 任 何 的 jar、 
pom 或 者 war 都 是 以 基于 这 些 基本 的 坐标 进行 区 分 的 。 


groupId 定 义 了 项 目 属于 哪个 组 ， 这 个 组 往往 和 项 目 所 在 的 组 织 或 
公司 存在 关联 。 璧 如 在 googlecode 上 建立 了 一 个 名 为 myapp 的 项 目 ， 那 
么 groupId 就 应 该 是 com.googlecode.myapp， 如 果 你 的 公司 是 mycom， 有 
一 个 项 目 为 myapp， 那 么 groupId 束 应 该 是 com.mycom.myapp“。 本 书 中 所 
有 的 代码 都 基于 groupId com.juvenxu.mvnbook ° 


artifactId 定 义 了 当前 Maven 项 目 在 组 中 唯一 的 ID ， 我 们 为 这 个 Hello 
World 项 目 定义 artifactId 为 hello-world， 本 书 其 他 章节 代码 会 分 配 其 他 的 
artifactId。 而 在 前 面 的 groupId 为 com.googlecode.myapp 的 例子 中 ， 你 可 
能 会 为 不 同 的 子 项 目 (模块 ; 分 配 artifactd， 如 myapp-util、myapp- 


domain、myapp-web 等 。 


顾名思义 ，version 指 定 了 Hello World 项 目 当 前 的 版 本 一 1.0- 
SNAPSHOT。SNAPSHOT 意 为 快照 ， 说 明 该 项 目 还 处 于 开发 中 ， 是 不 
稳定 的 版 本 。 随 着 项 目的 发 展 ，version 会 不 断 更 新 ， 如 升级 为 1.0、1.1- 


SNAPSHOT、1.1、2.0 等 。6.5 节 会 详细 介绍 SNAPSHOT， 第 13 章 会 介 
绍 如 何 使 用 Maven 管 理 项 目 版 本 的 升级 发 布 。 


最 后 一 个 name 元 陛 声 明了 一 个 对 于 用 户 更 为 友好 的 项 目 名 称 ， 虽 
然 这 不 是 必须 的 ， 但 还 是 推荐 为 每 个 POM 声 明 name， 以 方便 信息 交 


流 。 


没有 任何 实际 的 Java 人 代码， 我 们 束 能 够 定义 一 个 Maven 项 目的 
POM， 这 体现 了 Maven 的 一 大 优点 ， 它 能 让 项 目 对 象 模型 最 大 程度 地 
与 实际 代码 相 独 立 ， 我 们 可 以 称 之 为 解 簿 ， 或 者 正 交 性 。 这 在 很 大 程 
度 上 避免 了 Java 代 码 和 POM 代 码 的 相互 影响 。 比 如 当 项 目 需要 升级 版 
本 时 ， 只 需要 修改 POM， 而 不 需要 更 改 Java 代 码 ， 而 在 POM 稳 定之 
后 ， 日 音 的 Java 代 码 开 发 工作 基本 不 涉及 POM 的 修改 。 


3.2 ”编写 主 代码 


项 目 主 代码 和 测试 代码 不 同 ， 项 目的 主 代码 会 被 打包 到 最 终 的 构 
件 中 (Ahjar) ， 而 测试 代码 只 在 运行 测试 时 用 到 ， 不 会 被 打包 。 默 认 
情况 下 ，Maven 假 设 项 目 主 代码 位 于 src/main/java 目 录 ， 我 们 遵循 
Maven 的 约定 ， 创 建 该 目录 ， 然 后 在 该 目录 下 创建 文件 
com/juvenxu/mvnbook/helloworld/HelloWorld.java， 其 内 容 如 代码 清单 3- 


2 所 示 : 


代码 清单 3-2 Hello World 的 主 代 码 


a je m. Juvenxu.mvnbook. hellowor] 
public class Hell | 
publ St ng sayHell 
lello Ma 
} 
public static void main (String[] args) 
i System. out.print ( new HelloWorld().sayHello() ); 


这 是 一 个 简单 的 Java 类 ， 它 有 一 个 sayHello () 方法 ， 返 回 一 个 
String。 同 时 这 个 类 还 带 有 一 个 main 方 法 ， 创 建 一 个 HelloWorld 实 例 ， 
调用 sayHello () 方法 ， 并 将 结果 输出 到 控制 台 。 


关于 该 Java 代 码 有 两 点 需要 注意 。 首 先 ， 在 绝 大 多 数 情况 下 ， 应 该 
把 项 目 主 代码 放 到 src/main/java/ 目 录 下 (遵循 Maven 的 约定 ) ， 而 无 须 
额外 的 配置 ，Maven 会 自动 搜寻 该 目录 找到 项 目 主 代码 。 其 次 ， 该 Java 
类 的 包 名 是 com.juvenxu.mvnbook.helloworld， 这 与 之 前 在 POM 中 定义 
的 groupId 和 artifactId 相 吻合 。 一 般 来 说 ， 项 目 中 Java 类 的 包 都 应 该 基于 
项 目的 groupId 和 artifactId， 这 样 更 加 清晰 ， 更 加 符合 逻辑 ， 也 方便 搜索 
构件 或 者 Java 类 。 


代码 编写 完毕 后 ， 使 用 Maven 进 行 编译 ， 在 项 目 根 目录 下 运行 命 
mvn clean compile 会 得 到 如 下 输出 : 


INFO] Building Maven Hello World Project 


[INFO] task-segment: [clean, compile] 
NFO] 
INE [clean:clean lean}] 
INF leting dire € o-world\target 


[INFO] [resources :resources {execution: default-resources}] 


INFO] skip non existing resourceDirectory D: \code \hello-world\srce \main\re 
sources 

[INFO] [compiler:compile fexecution: default-compile}] 

[INFO] Compiling 1 source file to D: \code\hello-world\target \classes 

[INE 


[INFO] BUII CCESSFUL 


NFO] Total time:1s 

NFO) Finished at: Fri © 09 
[INFO] Final Memory: 9M/16M 
[INFO] 


clean 告 诉 Maven 清 理 输出 目录 targe，compile 告 诉 Maven 编 译 项 目 
主 代码 ， 从 输出 中 看 到 Maven 首 先 执行 了 clean: _ clean 任务， 删除 target/ 


目录 。 默 认 情 况 下 ，Maven 构 建 的 所 有 输出 都 在 target/ 目 录 中 ; 接着 执 
行 resources: resources 任 务 (未 定义 项 目 资源 ， 和 暂且 略 过 ) ; 最 后 执行 
compiler: compile 任 务 ， 将 项 目 主 代码 编译 至 target/classes 目 录 (编译 


好 的 类 为 com/juvenxu/mvnbook/helloworld/HelloWorld.Class) 


上 文 提 到 的 clean: clean ` resources: resources 和 compiler: compile 
对 应 了 一 些 Maven 插 件 及 插件 目标 ， 比 如 clean: clean 是 clean 插 件 的 
clean 目 标 ，compiler: compile 是 compiler 插 件 的 compile 目 标 。 后 文 会 详 
细 讲 述 Maven 皇 件 及 其 编写 方法 。 


至 此 ，Maven 在 没有 任何 额外 的 配置 的 情况 下 就 执行 了 项 目的 清理 
和 编译 任务 。 接 下 来 ， 编 写 一 些 单元 测试 代码 并 让 Maven 执 行 自动 化 测 
试 。 


3.3 ”编写 测试 代码 


为 了 使 项 目 结构 保持 清晰 ， 主 代码 与 测试 代码 应 该 分 别 位 于 独立 
的 目录 中 。3.2 方 讲 过 Maven 项 目 中 默认 的 主 代码 目录 是 src/main/java,， 
对 应 地 ，Maven 项 目 中 默认 的 测试 代码 目录 是 src/test/java。 因 此 ， 在 编 
写 测试 用 例 之 前 ， 应 当先 创建 该 目录 。 


在 Java 世 界 中 ， 由 Kent Beck 和 Erich Gamma 建 立 的 JUnit 是 事实 上 的 
单元 测试 标准 。 要 使 用 JUnit， 首 先 需 要 为 Hello World 项 目 添 加 一 个 
JUnit 依 赖 ， 修 改 项 目的 POM 如 代码 清单 3-3 所 示 : 


代码 清单 3-3” Hello World 的 POM 添 加 依赖 


<?xml version ="1.0" encoding = "UTF -8"?> 
<project xmins = "http://maven. apache. org/POMA.0.0" 
xmlns:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http://maven. apache. org/POMA.0.0 
http://maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < AnodelVersion > 
<groupid >com. juvenxu.mvnbook < /groupId > 
<artifactId >hello-world< /artifactId> 
<version >1.0-SNAPSHOT < /version > 
<name >Maven Hello World Project < /name > 
< dependencies > 
< dependency > 
<groupId > junit < /groupld > 
<artifactId >junit < /artifactId> 
<version >4.7 < /version > 
< scope >test < /scope > 
< /Aependency > 
< /Aependencies > 
< foroject > 


代码 中 添加 了 dependencies 元 素 ， 该 元 素 下 可 以 包含 多 个 
dependency 元 素 以 声明 项 目的 依赖 。 这 里 添加 了 一 个 依赖 
是 junit，artifactId 是 junit，version 是 4.7。 前 面 提 到 groupId、artifactId 和 
version 是 任何 一 个 Maven 项 目 最 基本 的 坐标 ，JUnit 也 不 例外 ， 有 了 这 
段 声明 ，Maven 整 能够 目 动 下 载 junit-4.7.jar°。 也 许 你 会 问 ，Maven 从 哪 
里 下 载 这 个 jar 呢 ? 在 Maven 之 前 ， 可 以 去 JUnit 的 官方 网 站 下 载 分 发 
包 ， 有 了 Maven， 它 会 目 动 访问 中 央 仓 库 

(http://repol.maven.org/maven2/) ， 下 载 需 要 的 文件 。 读 者 也 可 以 自己 
访问 该 仓库 ， 打 开路 径 juniVyjunity4.7/， 就 能 看 到 junit-4.7.pom 和 junit- 
4.7.jar。 人 第 6 章 会 详细 介绍 Maven 仓 库 及 中 央 仓 库 。 


groupld 


上 壕 POM 代 码 中 还 有 一 个 值 为 test 的 元 素 scope，scope 为 依赖 范 
围 ， 老 依赖 范围 为 test 则 表示 该 依赖 只 对 测试 有 效 。 换 句 话 说， 测试 代 
码 中 的 import JUnit 代 码 是 没有 问题 的 ， 但 是 如 果 在 主 代码 中 用 import 
JUnit 代 码 ， 束 会 造成 编译 错误 。 如 末 不 声明 依赖 范围 ， 那 么 默认 值 束 
是 compile， 表 示 该 依赖 对 主 代码 和 测试 代码 都 有 效 。 


配置 了 测试 依赖 ， 接 着 就 可 以 编写 测试 类 。 回 顾 一 下 前 面 的 
HelloWorld 类 ， 现 在 要 测试 该 类 的 sayHello () 方法 ， 检 查 其 返回 值 是 
否 为 “Hello Maven”。 在 src/test/java 目 录 下 创建 文件 ， 其 内 容 如 代码 清 
单 3-4 所 示 : 


代码 清单 3-4 Hello World 的 测试 代码 


c org, junit.Assert.assertEquals; 


a Test 

publ i tSayHe Ld 
HelloWorld hellc rld = new HelloWorld (); 
S g res = hell ] Hellol 
assertEquals ( "Hello Mave resul 


一 个 典型 的 单元 测试 包含 三 个 步骤 : 准备 测试 类 及 数据 ;G@) 执 行 
要 测试 的 行为 ， 人 检查 结果 。 上 述 样 例 首 先 初 始 化 了 一 个 要 测试 的 
HelloWorld 实 例 ， 接 着 执行 该 实例 的 sayHello O 方法 并 保存 结果 到 
result 变 量 中 ， 最 后 使 用 JUnit 框 架 的 Assert 类 检查 结果 是 否 为 我 们 期 户 
的 “Hello Maven”。 在 JUnit 3 中 ， 约 定 所 有 需要 执行 测试 的 方法 都 以 test 
开头 ， 这 里 使 用 了 JUnit 4， 但 仍然 遵循 这 一 约定 。 在 JUnit 4 中 ， 需 要 执 
行 的 测试 方法 都 应 该 以 @Test 进 行 标注 。 


测试 用 例 编写 完毕 之 后 就 可 以 调用 Maven 执 行 测试 。 运 行 mvn 


Clean test: 


[INFO] Scanning for projects... 

[INFO] 

[INFO] Building Maven Hello World Project 

[INFO] task-segment: [clean, test] 

[INFO] 

[INFO] {clean:clean apn wa default-clean}] 

[INFO] Deleting directory D: \git-juven \mvnbook \code \hello-world\target 
[INFO] [resources:resources {execution: default-resources }] 


Hown Load ng: http: an pea maven. org/maven2 /junit/junit/4.7 Aunit—4.7.pom 
1K downloaded (junit-4.7.pom) 

[INFO] [compi iler: Soest fexecution: default-compile}] 

[INFO] Compiling 1 source file to D: \code\hello-world\target \classes 
[INFO] [resources:testResources {execution: default-testResources}] 


Downloading: http://repol.maven. org/maven2 /junit/junit/4.7 Aunit-4.7.jar 
226K downloaded (junit-4.7.jar) 

[INFO] [compiler:testCompile {execution: default-testCompile}!] 

[INFO] Compiling 1 source file to D: \code \hello-world\target \test-classes 
[INFO] 


[ERROR] BUILD FAILURE 


[INFO] 
[INFO] Compilation failure 
D: \code \hello-world \ srce \ test \ java \ com \ juvenxu \mvnbook \ helloworld \ Hel- 
loworldTest. java: [8,5] -source 1.3 中 不 支持 注释 
(请 使 用 -source 5 或 更 高 版 本 以 启用 注释 ) 
@ Test 
[INFO] 


[INFO] For more information, run Maven with the-e switch 


不 六 的 是 构建 失败 了 ， 先 耐心 分 析 一 下 这 上段 输出 (为 了 本 书 的 简 
洁 ， 一 些 不 重要 的 信息 用 省 略 号 略 去 了 ) 。 命 令 行 输入 的 是 mvn clean 
test， 而 Maven 实 际 执行 的 可 不 止 这 两 个 任务 ， 还 有 clean: clean、 
resources: resources ` compiler: compile ` resources: testResources 以 及 
compiler: testCompile。 和 暂时 需要 了 解 的 是 ， 在 Maven 执 行 测试 (test) 
之 前 ， 它 会 先 自动 执行 项 目 主 资源 处 理 、 主 代码 编译 、 测 试 资源 处 


理 、 测 试 代码 编译 等 工作 ， 这 是 Maven 生 命 周 期 的 一 个 特性 。 本 书后 续 


章 世 会 详细 解释 Maven 的 生命 周期 。 


从 输出 中 还 看 到 : Maven 从 中 央 仓 库 下 载 了 junit-4.7.pom 和 junit- 
4.7.jar 这 两 个 文件 到 本 地 仓库 (~/.m2/repository) 中 ， 供 所 有 Maven 项 
目 使 用 。 


构建 在 执行 compiler testCompile 任 务 的 时 候 失 败 了 ，Maven 输 出 
提示 我 们 需要 使 用 -source 5 或 更 高 版 本 以 启动 注释 ， 也 就 是 前 面 提 到 的 
JUnit 4 的 @Test 注 解 。 这 是 Maven 初 学 者 常常 会 遇 到 的 一 个 问题 。 由 于 
历史 原因 ，Maven 的 核心 插件 之 一 一 compiler 搬 件 默 认 只 支持 编译 
Java 1.3， 因 此 需要 配置 该 插件 使 其 文 持 Java 5， 见 代码 清单 3-5。 


代码 清单 3-5 ”配置 maven-compiler-plugin 支 持 Java 5 


该 POM 省 略 了 除 插件 配置 以 外 的 其 他 部 分 。 我 们 暂且 不 去 关心 插 


件 配 置 的 细节 ， 只 需要 知道 compiler 插 件 支持 Java 5 的 编译 。 现 在 再 执 
行 mvn clean test， 输 出 如 下 : 


[INFO] [compiler:testCompile {execution: default-testCompile} 
[INFO] Compiling 1 source file to D: \code\hello-world\target \test-classes 

NFO] [surefire:test {execution: default-test }] 
O] Surefire report directory: D: \code \hello-world\target \surefire-reports 


Running com. juvenxu.mvnbook. helloworld. HelloWorldTest 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 


, Time elapsed: 0.055 sec 
Results 
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0 
INFO 


[INFO] BUILD SUCCESSFUL 


我 们 看 到 compiler testCompile 任 务 执 行 成 功 了 ， 测 试 代 码 通过 编 
译 之 后 在 targettest-classes 下 生成 了 二 进 制 文件 ， 紧 接着 surefire: test 任 
务 运 行 测试 ，surefire 是 Maven 中 负责 执行 测试 的 插件 ， 这 里 它 运行 测试 
用 例 HelloWorldTest， 并 且 输 出 测试 报告 ,显示 


共 运 行 了 多 少 测试 ， 
失败 了 多 少 ， 出 错 了 多 少 ， 跳 过 了 多 少 。 显 然 ， 我 们 的 测试 通过 了 。 


3.4 打包 和 运行 


将 项 目 进行 编译 、 测 试 之 后 ， 下 一 个 重要 步骤 束 是 打包 
(package) 。Hello World 的 POM 中 没有 指定 打包 类 型 ， 使 用 默认 打包 
并 行 打包 ， 可 以 看 到 如 下 输 


类 型 jar。 人 简单 地 执行 命令 mvn clean package 进 


出 : 
et ru Fai re 0, Errors: 0, Skipped: 0 
INFO) [jar:jar {e cuti n: default-jar}] 
[INFO] Bi Gita jing jar: D: este \hello-world\target \hello-worid-1.0-SNAPSHOT. jar 
NFO] 
[INFO] BUILD SUCCESSFUL 
会 在 打包 之 前 执行 编译 、 测 试 等 操作 。 这 里 看 到 


类 似 地 ，Maven 会 
jar: jar 任 务 负 责 打 包 ， 实 际 上 就 是 jar 插 件 的 jar 目 标 将 项 目 主 代码 打包 


成 一 个 名 为 hello-world-1.0-SNAPSHOT.jar 的 文件 。 该 文件 也 位 于 target/ 
了 命名 的 ， 如 有 和 需要， 


里 暂且 不 展开 ， 后 面 


输出 目录 中 ， 它 是 根据 artifact-version.jar 规 则 3 
还 可 以 使 用 finalName 来 目 定 义 该 文件 的 名 称 ， 


会 详细 解释 < 
至 此 ， 我 们 得 到 了 项 目的 输出 ， 如 果 有 需要 的 话 ， 就 可 以 复制 这 
Be, Anta 


Njar 文 件 到 其 他 项 目的 Classpath 中 从 而 使 用 HelloWorld 类 。 但 
Djar? 还 需要 一 个 安装 的 步骤 ， 


才能 让 其 他 的 Maven 项 目 直接 引用 这 


执行 mvn clean install: 


[INFO] [jar:jar fexecution: default-jar} 


[INFO] Building jar: D: \code\hello-world \target \hello-world-1.0-SNAPSHOT. jar 
5] [instal 1: default-install}] 


C: \Users \ juven \ 0 
hello-world-1.0-SNAPSHOT. ja 


[INFO] 


在 打包 之 后 ， 又 执行 了 安装 任务 install: install。 从 输出 可 以 看 到 
该 任务 将 项 目 输出 的 jar 安 装 到 了 Maven 本 地 仓库 中 ， 可 以 打开 相应 的 文 
件 夹 看 到 Hello World 项 目的 pom 和 jar。 之 前 讲述 JUnit 的 POM 及 jar 的 下 
载 的 时 候 ， 我 们 说 只 有 构件 被 下 载 到 本 地 仓库 后 ， 才 能 由 所 有 Maven 项 
目 使 用 ， 这 里 是 同样 的 道理 ， 只 有 将 Hello World 的 构件 安装 到 本 地 仓 
库 之 后 ， 其 他 Maven 项 目 才能 使 用 它 。 


我 们 已 经 体验 了 Maven 最 主要 的 命令 : mvn clean compile ` mvn 
clean test `œ mvn clean package ` mvn clean install ° 执行 test 之 前 是 会 先 执 
行 compile 的 ， 执 行 package 之 前 是 会 完 执 行 test 的 ， 而 类 似 地 ，install 之 
前 会 执行 package。 可 以 在 任何 一 个 Maven 项 目 中 执行 这 些 命令 ， 而 且 
我 们 已 经 清楚 它们 是 用 来 做 什么 的 。 


到 目前 为 止 ， 还 没有 运行 Hello World 项 目 ， 不 要 忘 了 HelloWorld 类 
可 是 有 一 个 main 方 法 的 。 默 认 打包 生成 的 jar 是 不 能 够 直接 运行 的 ， 
为 带 有 main 方 法 的 类 信息 不 会 添加 到 manifest 中 (打开 jar 文 件 中 的 
META-INFIMANIFESTME 文 件 ， 将 无 法 看 到 Main-Class 一 行 ) 。 为 了 


生成 可 执行 的 jar 文 件 ， 需 要 借助 maven-shade-plugin， 配 置 该 插件 如 
下 : 


<plugin> 
< groupId >org. apache. maven. plugins < /groupId > 


ade-plugin < /artifactId> 


<artifactId >maven-: 
ersion>1.2.1</version> 
<executions > 
<execution > 
<phase >package < /phase > 
<goals > 
<goal >shade < /goal > 
< /goals > 
<configuration > 
<transformers > 
<transformer implementation = "org, apache, maven. plugins. shade. resource. 
ManifestResourceTransformer" > 
<mainClass >com. juvenxu. mvnbook. helloworld. HelloWorld < /mainClass > 
< /transtormer > 
< /transformers > 
< /configuration > 
< /execution > 
< /executions > 


< /plugin > 


plugin 元 素 在 POM 中 的 相对 位 置 应 该 在 <project><build><plugins> 下 
面 。 我 们 配置 了 mainClass 为 
com.juvenxu.mvnbook.helloworld.HelloWorld， 项 目 在 打包 时 会 将 该 信息 
放 到 MANIFEST 中 。 现 在 执行 mvn clean install， 答 构建 完成 之 后 打开 


target/ 目 隶 ， 可 以 看 到 hello-world-1.0-SNAPSHOT.jar 和 original-hello- 
world-1.0-SNAPSHOT.jar， 前 者 是 带 有 Main-Class 信 息 的 可 运行 jar， 后 
者 是 原始 的 jar， 打 开 hello-world-1.0-SNAPSHOT.jar 的 META- 
INF/MANIFESTMF， 可 以 看 到 它 包 含 这 样 一 行 信息 : 


Main-Class: com. juvenxu.mvnbook. helloworld. HelloWorld 


现在 ， 在 项 目 根 目 孙 中 执行 该 jar 文 件 : 


D: \code \hello-world >java-jar target \hello-world-1.0-SNAPSHOT. jar 


Hello Maven 
控制 台 输 出 为 Hello Maven， 这 正 是 我 们 所 期 望 的 。 


本 小 节 介 绍 了 Hello World 项 目 ， 侧 重点 是 Maven 而 韭 Java 代 码 本 
身 ， 介 绍 了 POM、Maven 项 目 结构 以 及 如 何 编译 、 测 试 、 打 包 等 。 


3.5 EH Archetype I H 2R 


Hello World 项 目 中 有 一 些 Maven 的 约定 : 在 项 目的 根 目录 中 放置 
pom.xml， 在 src/main/java 目 录 中 放置 项 目的 主 代码 ， 在 src/test/java 中 放 
置 项 目的 测试 代码 。 之 所 以 一 步 一 步 地 展示 这 些 步 又 ， 是 为 了 能 让 可 
能 是 Maven 初 学 者 的 你 得 到 最 实际 的 感受 。 我 们 称 这 些 基本 的 目录 结构 
和 pom.xml 文 件 内 容 称 为 项 目的 骨架 ， 当 第 一 次 创建 项 目 骨 染 的 时 候 ， 
你 还 会 饶 有 兴趣 地 去 体会 这 些 默 认 约定 背后 的 思想 ， 第 二 次 ， 第 三 
次 ， 你 也 许 还 会 满意 自己 的 熟练 程度 ， 但 第 四 、 人 第 五 次 做 同样 的 事 
情 ， 你 可 能 就 会 恼火 了 。 为 此 Maven 提 供 了 Archetype 以 帮助 我 们 快速 
勾勒 出 项 目 骨架 。 


还 是 以 Hello World 为 例 ， 我 们 使 用 maven archetype 来 创建 该 项 目的 
上 骨架， 离开 当前 的 Maven 项 目 日 录 。 


如 果 是 Maven 3， 人 简单 地 运行 : 


如 果 是 Maven 2， 最 好 运行 如 下 命令 : 


mvn org. apache. maven. plugins :maven-archetype-plugin:2.0-alpha-5 :generate 


很 多 资料 会 让 你 直接 使 用 更 为 简单 的 mvn archetype: generate 命 
令 ， 但 在 Maven 2 中 这 是 不 安全 的 ， 因 为 该 命令 没有 指定 Archetype 插 件 
的 版 本 ， 于 是 Maven 会 自动 去 下 载 最 新 的 版 本 ， 进 而 可 能 得 到 不 稳定 的 
SNAPSHOT 版 本 ， 导 致 运行 失败 。 然 而 在 Maven 3 中 ， 即 使 用 户 没有 指 
定 版 本 ，Maven 也 只 会 解析 最 新 的 稳定 版 本 ， 因 此 这 是 安全 的 。 具 体内 


容 见 7.7 节 。 


我 们 实际 上 是 在 运行 插件 maven-archetype-plugin， 注 意 冒 号 的 分 
阳 ， 其 格式 为 groupId: artifactId: version: goal, 
org.apache.maven.plugins 是 maven 官 方 插件 的 groupId，maven-archetype- 
plugin 是 Archetype 插 件 的 artifactId，2.0-alpha-5 是 目前 该 插件 最 新 的 稳 
定 版 ，generate 是 要 使 用 的 插件 目标 。 


紧 接 着 会 看 到 一 段 长 长 的 输出 ， 有 很 多 可 用 的 Archetype 供 选择 ， 
包括 著名 的 Appfuse 项 目的 Archetype、JPA 项 目的 Archetype 等 。 每 一 人 1 
Archetype 前 面 都 会 对 应 有 一 个 编号 ， 同 时 命令 行 会 提示 一 个 默认 的 编 
号 ， 其 对 应 的 Archetype 为 maven-archetype-quickstart， 直 接 回 车 以 选择 
该 Archetype， 紧 接着 Maven 会 提示 输入 要 创建 项 目的 groupId、 
artifactId、version 以 及 包 名 package。 如 下 输入 并 确认 : 


Defi l Í group! m. 3\ NXU.I k 
Define 1 f artifactid hello-world 
Define value for version: 1.0-SNAPSHOT: : 
Define value for package: com. juvenxu.mvnbook: : com. juvenxu.mvynbook. helloworld 
nfirm ation: 
yroupid 90k 
tifact] 
ers i ON 
ackage m. J 1 wnbook. hell 1 
y 


Archetype 揪 件 将 根据 我 们 提供 的 信息 创建 项 目 骨 架 。 在 当前 目录 
下 ，Archetype 插 件 会 创建 一 个 名 为 hello-world (我 们 定义 的 artifactId) 
的 子 目 录 ， 从 中 可 以 看 到 项 目的 基本 结构 : 基本 的 pom.xml 已 经 被 创 
建 ， 里 面包 含 了 必要 的 信息 以 及 一 个 junit 依 赖 ， 主 代码 目录 
src/main/java 已 经 被 创建 ， 在 该 目录 下 还 有 一 个 Java 类 
com.juvenxu.mvnbook.helloworld.App， 注 意 这 里 使 用 到 了 刚才 定义 的 包 
名 ， 而 这 个 类 也 仅仅 只 有 一 个 简单 的 输出 Hello World! 的 main 方 法 ; 
测试 代码 目录 src/testjava 也 被 创建 好 了 ， 并 且 包 含 了 一 个 测试 用 例 


com.juvenxu.mvnbook.helloworld.AppTest ° 


Archetype 可 以 帮助 我 们 迅速 地 构建 起 项 目的 骨架 ， 在 前 面 的 例子 
中 ， 我 们 完全 可 以 在 Archetype 生 成 的 骨架 的 基础 上 开发 Hello World 项 
目 以 地 省 大 量 时 间 。 


此 外 ， 这 里 仅仅 是 看 到 了 一 个 最 简单 的 Archetype， 如 果 有 很 多 项 
目 拥有 类 似 的 目 定义 项 目 结构 以 及 配置 文件 ， 则 完全 可 以 一 荔 永 逸 地 
开发 目 己 的 Archetype， 然 后 在 这 些 项 目 中 使 用 目 定义 的 Archetype 来 快 


速生 成 项 目 骨 涤 。 本 书后 面 的 章节 会 详细 阐述 如 何 开发 Maven 
Archetype ° 


3.6 m2eclipse taj = (52 FA 


介绍 前 面 Hello World 项 目的 时 候 ， 并 没有 涉及 IDE， 如 此 简单 的 
一 个 项 目 ， 使 用 最 简单 的 编辑 絮 也 能 很 快 完成 。 但 对 于 稍微 大 一 些 的 
项 目 来 说 ， 没 有 IDE 了 就 是 不 可 想象 的 。 本 和 介绍 m2eclipse 的 基本 使 
用 o 


3.6.1 A Maven H 


第 2 章 介 绍 了 如 何 安装 m2eclipse， 现 在 ， 使 用 m2ecilpse 导 入 Hello 
World 项 目 。 选 择 沫 单项 File， 然 后 选择 Import， 我 们 会 看 到 一 个 Import 
对 话 框 。 在 该 对 话 框 中 选择 General 目录 下 的 Maven Projects， 然 后 单 击 
Next 按 钮 ， 就 会 出 现 Import Projects 对 话 框 。 在 该 对 话 框 中 单 击 Browse 
按钮 选择 Hello World 的 根 目 录 〈 即 包含 pom.xml 文 件 的 那个 目录 ) ， 这 
时 对 话 框 中 的 Projects: 部 分 就 会 显示 该 目录 包含 的 Maven 项 目 ， 如 图 3- 
1 所 示 。 


Maven Projects | 
Select Maven projects 


Root Directory; D:\git-juven\maven-book\code\ch-3 
Projects: 
圆 /pom.xml - comjuvenxu.mvnbook:hello-world:1.0-SNAPSHOT-jar 


[E] Add project(s) to working set 


Working set: | 


» Advanced 


图 3-1 在 Eclipse 中 导入 Maven 项 目 


单 击 Finish 按 钮 之 后 ，m2ecilpse 就 会 将 该 项 目 导入 到 当前 的 
workspace 中 ， 导 入 完成 之 后 ， 就 可 以 在 Package Explorer 视 图 中 看 到 图 
3-2 所 示 的 项 目 结构 。 


4 $y hello-world 
4 CS src/main/java 
4 # com juvenxu.mvnbook.helloworld 
b [D HelloWorld.java 
4 ES src/test/java 
4 #8 com juvenxu.mvnbook.helloworld 
b D HelloworldTestjava 


> mÀ JRE System Library (J2SE-1,5] 
4 BA Maven Dependencies 
> Qs junit-4.7jar - D:\java\repository\junit\junit\4.7 
> @ sre 
> & target 
w pom.xml 


图 3-2 ”Eclipse 中 导入 的 Maven 项 目 结构 


我 们 看 到 主 代码 目录 src/main/java 和 测试 代码 目录 src/test/java 成 了 
Eclipse 中 的 资源 目录 ， 包 和 类 的 结构 也 十 分 清晰 。 当 然 pom.xml 永 远 在 
项 目的 根 目录 下 ， 而 从 这 个 视图 中 甚至 还 能 看 到 项 目的 依赖 junit- 
4.7.jar， 其 实际 的 位 置 指向 了 Maven 本 地 仓库 (这 里 自 定 义 了 Maven 本 
地 仓库 地 址 为 D: Mavarepository。 后 续 章 和 会 介绍 如 何 目 定 义 本 地 仓 
EMA) ° 


3.6.2 ”创建 Maven 项 目 


创建 一 个 Maven 项 目 也 十 分 简单 ， 选 择 染 单项 File ~ New > Other, 
在 弹出 的 对 话 框 中 选择 Maven 下 的 Maven Project， 然 后 单 击 Next 按 钮 ， 
在 弹出 的 New Maven Project 对 话 框 中 ， 使 用 默认 的 选项 (不 要 选择 
Create a simple project m, HERM thet MH Maven Archetype) ， 单 
击 Next 按 钮 ， 此 时 m2eclipse 会 提示 我 们 选择 一 个 Archetype。 这 里 选择 
maven-archetype-quickstart， 再 单 击 Next 按 钮 。 由 于 m2eclipse 实 际 上 是 
在 使 用 maven-archetype-plugin 插 件 创建 项 目 ， 因 此 这 个 步骤 与 上 一 万 使 
用 archetype 创 建 项 目 骨 架 类 似 ， 输 入 groupId ` artifactld ` version ` 
package (暂时 不 考 虚 Properties) ， 如 图 3-3 所 示 。 


@ New Maven Project 


New Maven project 


Specify Archetype parameters 


Group Id: comjuvenxu.mynbook 


Artifact Id: hello-world-m2e 


Version: 0.0.1-SNAPSHOT v 


Package: comjuvenxu.helloworldm2e 
Properties available from archetype: 


Name Value 


图 3-3 ”在 Eclipse 中 使 用 Archetype 创 建 项 目 


注意 ， 为 了 不 和 前 面 已 导入 的 Hello World 项 目 产 生 冲 突 和 混 消 ， 
这 里 使 用 不 同 的 artifactId 和 package。 单 击 Finish 按 钮 ，Maven 项 目 就 创 
建 完 成 了 。 其 结构 与 前 一 个 已 导入 的 Hello World 项 目 基本 一 致 。 


我 们 需要 在 命令 行 输入 如 mvn clean install 之 类 的 命令 来 执行 maven 
构建 ，m2eclipse 中 也 有 对 应 的 功能 。 在 Maven 项 目 或 者 pom.xml 上 右 
击 ， 再 在 弹出 的 快捷 菜单 中 选择 Run As， 就 能 看 到 常见 的 Maven 命 令 ， 
如 图 3-4 所 示 。 


Assign Working Sets... 

Run As | S 1 Java Applet Alt+Shift+x, A 
Debug As | 2 Java Application Alt+Shift+X, J 
Validate Ju 3 JUnit Test Alt+Shift+x, T 
Maven 4 Maven assembly:assembly 

Team 5 Maven build Alt+Shift+x, M 
Compare With 6 Maven build... 

Restore from Local History... 7 Maven clean 

8 Maven generate-sources 


Properties Alt+Enter 
9 Maven install 


[INFO] BUILD suc¢ m2 Maven package 
[INFO] 

[INFO] Total time 
[INFO] Finished ¢™ Maven test 
[INFO] 
[INFO] 


Maven source;jar 


Run Configurations... 


图 3-4 在 Eclipse 中 运行 默认 mvn 命 令 


选择 想 要 执行 的 Maven 命 令 就 能 执行 相应 的 构建 ， 同 时 也 能 在 
Eclipse 的 console 中 看 到 构建 输出 。 这 里 第 见 的 一 个 问题 是 ， 默 认 选 项 
中 没有 我 们 想 要 执行 的 Maven 命 令 怎么 办 ? 比如， 默认 带 有 mvn test, 
但 我 们 想 执行 mvn clean test， 很 简单 ， 选 择 Maven build 以 自 定 义 Maven 
运行 命令 ， 在 弹出 对 话 框 的 Goals 一 项 中 输入 我 们 想 要 执行 的 命令 ， 如 


clean test， 设 置 一 下 Name， 单 击 Run 即 可 。 并 且 ， 下 一 次 我 们 选择 
Maven build， 或 者 使 用 快捷 键 “Alt+ShifttrXx，M” 快 速 执 行 Maven 构 建 的 
时 候 ， 上 次 的 配置 直接 就 能 在 历史 记录 中 找到 。 图 3-5 所 示 就 是 自 定义 


Maven 运 行 命 令 的 界面 。 


Edit configuration and launch. 


Name: hello-world 


EÀ JRE | Ñ Refresh | BJ Environment) 下 Common 
Base directory: 
D:/git-juven/maven-book/code/ch-3/hello- 


Goals: clean test 

Profiles: 
Offline Update Snapshots 
Debug Output Skip Tests Non-recursive 
Resolve Workspace artifacts 


Parameter Name Value 


Maven Runtime: 


图 3-5 ”在 Eclipse 中 目 定义 mvn 命 令 


3.7 NetBeans Maven 插 件 简单 使 用 


NetBeans 的 Maven 插 件 也 十 分 位 单 易 用 ， 我 们 可 以 轻松 地 在 
NetBeans 中 导入 现 有 的 Maven 项 目 ， 或 者 使 用 Archetype 创 建 Maven 项 


目 ， 还 能 够 在 NetBeans 中 直接 运行 mvn 命 令 。 


3.7.1 ”打开 Maven 项 日 


与 其 说 打开 Maven 项 目 ， 不 如 称 之 为 导入 更 为 合适 ， 因 为 这 个 项 目 
不 需要 是 NetBeans 创 建 的 Maven 项 目 。 不 过 这 里 还 是 遵照 NetBeans 有 菜单 
中 使 用 的 名 称 。 


选择 荣 单 栏 中 的 文件 ， 然 后 选择 打开 项 目 ， 直 接 定 位 到 Hello 
World 项 目的 根 目 隶 ，NetBeans 会 十 分 智能 地 识别 出 Maven 项 目 ， 如 图 
3-6 所 示 。 


查看 : cy DATAPART1 0D:) -| ce 


i Œ af library MEABE P): 
: i Maven Hello World Project (jar) | 
E 8 oi cd 回 作为 主 项 目 打开 M) 
i; E-a ch-10 
由 - 昌 cw 中 打开 所 需 的 项 目 R): 
| 由 -而 ch-17 
由 - 烛 chis 
i a be ch-3 
PE 


由 di. uitia 


文件 名 : : \git-juven\maven-book\code\ch-3\hello-world 打开 项 目 
文件 类 型 : REZAR a 


图 3-6 ”在 NetBeans 中 导入 Maven 项 目 


Maven 项 目的 图 标 有 别 于 一 般 的 文件 夹 ， 单 击 打开 项 目 后 ，Hello 
World 项 目 就 会 被 导入 到 NetBeans 中 ， 在 项 目 视 图 中 可 以 看 到 图 3-7 所 示 
的 项 目 结构 。 


NetBeans 中 项 目 主 代码 目录 的 名 称 为 源 包 ， 测 试 代码 目录 成 了 测 
试 包 ， 编 译 范围 依赖 为 库 ， 测 试 范 围 依 赖 为 测试 库 。 这 里 也 能 看 到 
pom.xml，NetBeans 甚 至 还 帮 有 我 们 引用 了 settings.xml。 


=) Maven Hello World Project (jar) 
ai 源 包 
B B com. juvenxu. mvnbook. helloworld 
-B HelloWorld. java 
a 7 mite 
: oe com. juvenxu. mvnbook. helloworld 
-图 HelloWorldlest. java 
~a F 


S mte 
由 fs junit-4 7.jar [test] 
日- 项 目 文件 


pom. xml 


settings. xml 


图 3-7 NetBeans 中 导入 的 Maven 项 目 结 构 


3.7.2 ”创建 Maven 项 目 


在 NetBeans 中 创建 Maven 项 目 同 样 十 分 轻松 。 在 菜单 栏 中 选择 文 

件 ， 然 后 选择 新 建 项 目 ， 在 弹出 的 对 话 框 中 ， 选 择 项 目 类 别 为 Maven， 
项 目 为 Maven 项 目 ， 单 击 “ 下 一 步 ” 按 钮 之 后 ， 对 话 框 会 提示 我 们 选择 
Maven 原 型 ( 即 Maven Archtype) 。 这 里 选择 Maven 快 速 启动 原型 

(1.0) ， 即 前 文 提 到 的 maven-archetype-quickstart， 单 击 “ 下 一 步 ” 按 钮 
之 后 ， 输 入 项 目的 基本 信息 。 这 些 信息 在 之 前 讨论 Archetype 及 在 
m2eclipse 中 创建 Maven 项 目的 时 候 都 仔细 解释 过 ， 这 里 不 再 详 述 ， 如 图 
3-8 所 示 。 


ER 名 称 和 位 置 


1 选择 项 目 MEPER: Maven Hello World NetBeans 
2. Maven 原型 - 


3. pa 项 目 位 置 1): |c: \Users\Juven Xu\Documents\NetBeansProjects WA O)... 


MEZHER O): [Documents \NetBeansProjects\Maven Hello World NetBeans 


工件 Ia (A): |MavenHel] oWorldletBeans 


组 Id G): feom juvenxu. mvnbook 


mkV): |1. O-SMAPSHOT 


ae): |com. juvenxu. mynbook. mavenhelloworldnetbeans 


EME... 


T-# 


图 3-8 在 NetBeans 中 使 用 Archetype 创 建 Maven 项 目 


ABEER HAZ, “Sera Maventil Emi ele T 。 


3.7.3 ”运行 mvn 命 令 


NetBeans 在 默认 情况 下 提供 两 种 Maven 运 行 方式 ， 单 击 菜单 栏 中 的 
运行 ， 可 以 看 到 生成 项 目 和 清理 并 生成 项 目 两 个 选项 。 可 以 笑 斌 “点击 
运行 Maven 构 建 ”， 根 据 NetBeans 控 制 台 的 输出 ， 束 能 发 现 它们 实际 上 


对 应 了 mvan install 和 mvn clean install 两 个 命令 。 


在 实际 开发 过 程 中 ， 我 们 往往 不 会 满足 于 这 两 种 商 单 的 方式 。 比 
如 ， 有 时 候 我 们 只 想 执 行 项 目的 测试 ， 而 不 需要 打包 ， 这 时 就 希望 能 
够 执行 mvn clean test 命 令 ， 所 注 的 是 NetBeans Maven ff ELF H E 
义 的 mvn 命 令 配 置 。 


FERRE PLA, RARAN, PONTE ae Ee 
择 其 他 ， 在 下 面 选择 Maven 标 签 栏 。 在 这 里 可 以 对 NetBeans Maven 插 件 
进行 全 局 的 配置 《还 记得 第 2 章 中 如 何 配置 NetBeans 使 用 外 部 Maven 
吗 ? ) 。 现 在 ， 选 择 倒数 第 三 行 的 编辑 全 局 定制 目标 定义 ...， 添 加 一 个 
名 为 Maven Test 的 操作 ， 执 行 日 标 为 clean test， 和 暂时 不 考虑 其 他 配置 选 
项 ， 如 图 3-9 所 示 。 


[Gr 生成 加 | Iveseript | Sora WB] "ven wees | Ha |e [on | [a 


(ERARI Maven 版 本 : 3. O-SNAPSHOT ) 


外 部 Maven Home 目录 : | 
(EFA Maven 版 本 : 2.2.1 (位 于 PATH 环境 交 鲁 中 》 


全 局 执行 选项 0): | © 25 Maven 目标 定义 
ESR | 操作 cr): 
本 地 资源 库 L): 


项 目 打开 时 : 


下 载 二 进 制 文件 0): [ME 
检查 Javadoc: | 


执行 目标 Œ): p= test 
激活 配置 文件 (P): | 
设置 属性 (S): 


检查 源 G): 从 不 
请 注意 ， 将 其 中 任何 一 项 设置 为 “ 


编辑 全 局 定制 目标 定义 .… - 


索引 更 新 频率 0): [一周 一次 
在 本 地 索引 中 包 


图 3-9 ”在 NetBeans 中 自 定 义 mvn 命 令 


单 击 “ 缺 省 保存 该 配置 *， 在 Maven 项 目 上 右 击 ， 选 择 定制 ， 就 能 看 
到 刚才 配置 好 的 Maven 运 行 操作 。 选 择 Maven Test 之 后 ， 终 端 将 执行 
mvn clean test。 值 得 一 提 的 是 ， 也 可 以 在 项 目 上 右 击 ， 选 择 定 制 ， 再 选 
择 目标 ， 再 输入 想 要 执行 的 Maven 目 标 (如 clean package) ， 单 击 “ 确 
定 ” 按 钮 之 后 NetBeans 束 会 执行 相应 的 Maven 命 令 。 这 种 方式 十 分 便 
捷 ， 但 这 是 临时 的 ， 该 配置 不 会 被 保存 ， 也 不 会 有 历史 记录 。 


3.8 ”小 结 


本 半 以 尽 可 能 简单 且 详细 的 方式 客 述 了 一 个 Hello World 项 目 ， 重 
点 解释 了 POM 的 基本 内 容 、Maven 项 目的 基本 结构 以 及 构建 项 目 基本 
的 Maven 命 令 。 在 此 基础 上 ， 还 介绍 了 如 何 使 用 Archetype 快 速 创建 项 
目 骨架 。 最 后 讲述 的 是 如 何在 Eclipse 和 NetBeans 中 导入 、 创 建 及 构建 
Maven 项 目 。 


简单 的 账户 注册 服务 
RM 

简要 设计 

小 结 


前 儿 半 已 经 大 概 解 释 了 Maven 是 什么 ， 并 且 介 绍 了 Maven 的 安 效 
和 最 基本 的 使 用 。 从 本 章 开 始 ， 引 入 一 个 较为 真实 的 育 景 案例 ， 以 演 
示 Maven 使 用 的 真实 场景 。 由 于 本 书 的 主题 征 Maven， 我 们 不 想 让 项 
目 变 得 过 于 复杂 ， 或 者 涉及 过 多 的 技术 ， 因 此 该 案例 的 目的 还 是 帮助 
我 们 理解 Maven 的 概念 ， 以 及 展示 大 部 分 Maven 项 目 需要 面 对 和 处 理 


的 一 些 问题 。 


建议 读者 至 少 大 概 浏 览 本 章 内 容 ， 因 为 本 章 是 几乎 所 有 后 续 章 
的 背景 ， 了 解 了 背景 需求 ， 将 能 够 更 好 地 理解 相关 Maven 概 念 及 实践 
的 前述 


4.1 和 何 单 的 账户 注册 服务 

注册 互联 网 账户 是 日 常生 活 中 再 熟悉 不 过 的 一 件 事情 ， 作 为 一 个 
用 户 ， 注 册 账 户 的 时 候 往往 需要 做 以 下 事情 

提供 一 个 未 被 使 用 的 账号 ID 


-提供 一 个 未 被 使 用 的 email 地 址 


-提供 一 个 任意 的 显示 名 称 


设置 安全 密码 ， 并 重复 输入 以 确认 


-输入 验证 码 


-前往 邮箱 得 收 油 活 链接 并 单 击 激活 账号 


登录 


账号 的 ID 和 email 地 址 都 可 以 用 来 唯一 地 标识 某 个 账户 ， 而 显示 名 
称 则 用 来 显示 在 页 面 上 上， 方便 浏 览 。 注 册 的 时 候 用 户 还 需要 输入 两 次 
密码 ， 以 确保 没有 输 错 。 系 统 则 需要 负责 检查 ID 和 email 的 唯一 性 ， 验 
证 两 次 输入 的 密码 是 否 一 致 。 人 验证 码 是 由 系统 随机 生成 的 只 能 由 肉眼 
识别 其 内 容 的 图 片 ， 可 以 有 效 防 止 机 融 恶 意 批 量 注 册 ， 才 输入 正确 的 
验证 码 信息 ， 系 统 则 会 进行 检查 ， 如 采 验 证 码 错误 ， 系 统 会 生成 并 返 


回 新 的 验证 码 。 一 旦 所 有 检查 都 没 问 题 了 ， 系 统 吏 会 生成 一 个 激活 链 
接 ， 并 发 送 到 用 户 的 邮箱 中 。 单 击 沿 活 链接 后 ， 账 户 束 被 激活 了 ， 这 
时 账户 注册 完成 ， 用 户 可 以 进行 登录 。 


对 于 一 个 账户 注册 服务 ， 还 需要 考虑 一 些 安全 因素 。 例 如 ， 需 要 
在 服务 右 端 密 文 地 保存 密码 ， 检 查 密 码 的 强 弱 程 度 ， 更 进一步 则 需要 
考虑 验证 码 的 失效 时 间 ， 激 活 链接 的 失效 时 间 ， 等 等 。 


本 章 的 主要 目的 是 让 读者 清楚 地 了 解 这 个 背景 案例 ， 即 账户 注册 
服务 ， 它 的 需求 是 什么 ， 基 于 这 样 的 一 个 需求 ， 我 们 会 怎样 设计 这 个 
小 型 的 系统 。 本 章 的 描述 几乎 不 会 涉及 Maven， 但 后 面 的 章 下 在 讲述 
各 种 Maven 概 念 和 实践 的 时 候 ， 都 会 基于 这 一 实际 的 育 景 案例 。 


4.2 ”需求 前 述 


了 解 账户 注册 服务 之 后 ， 下 面 从 软件 工程 的 视角 来 分 析 一 下 该 服 


务 的 需求 。 


4.2.1 需求 用 例 


为 了 帮助 读者 详细 地 了 解 账户 注册 服务 的 需求 ， 这 里 正式 前 述 一 
下 账户 注册 服务 的 需求 用 例 ， 见 图 4-1。 


PEGE: 
.用 户 访问 注册 页 面 
， 系 统 生 成 验证 码 图 片 
. 用户 输 入 想 要 的 1D、Email 地 址 ， 想 要 的 显示 名 称 、 密 码 、 确 认 密 码 
， 用 户 输入 验证 码 
， 用 户 提交 注册 请 求 
， 系 统 检查 验证 码 
， 系 统 检查 ID 是 否 已 经 被 注册 ，Email 是 否 已 经 被 注册 ， 密 码 和 确认 密码 是 否 一 致 
， 系 统 保存 未 激活 的 账户 信息 
.系统 生成 激活 链接 ， 并 发 送 至 用 户 邮 箱 
10. 用 户 打 开 邮 箱 ， 访 问 激活 链接 
11. 系 统 解析 激活 链接 ， 激 活 相 关 账 户 


12. 用户 使 用 ID 和 密码 登录 


D RGR: 

4a: 用 户 无 法 看 清 验证 码 ， 请 求 重新 生成 
1. Bee BERR 2 

6a: 系统 检测 到 用 户 输入 的 验证 码 错误 
1. ”系统 提示 验证 码 错误 
2. ” 跳 转 到 步骤 2 


7a: 系统 检测 到 ID 已 被 注册 ， 或 者 Email 已 被 注册 ， 或 者 密码 和 确认 密码 不 一 致 


1. ”系统 提示 相关 错误 信息 
2，” 跳 转 到 步 又 2 


图 4-1 ”账户 注册 服务 需求 用 例 


该 注册 账户 用 例 包 售 了 一 个 主要 场景 和 几 个 扩展 场景 。 该 用 例 的 
角色 只 有 两 个 : 用 户 和 系统 。*“ 主 要 场景 "描述 了 用 户 如 何 与 系统 一 步 
一 步 地 交互 ， 并 且 成 功 完 成 注册 。 中 展 场景 " 则 描述 了 一 些 中 途 发 生 
意外 的 情形 ， 比 如 用 户 输 错 验 证 码 的 时 候 ， 系 统 束 需要 重新 生成 验证 
码 ， 用 户 也 需要 重新 输入 验证 码 。 


该 用 例 没有 涉及 非 功 能 性 需求 (如 安全 性 ) ， 也 没有 详细 定义 用 
己 界 面 ， 用 例 也 不 会 告诉 我 们 使 用 何 种 技术 。 关 于 该 服务 的 安全 性 ， 
你 将 会 看 到 一 些 实际 的 措施 ， 但 我 们 不 会 过 于 深入 ;关于 用 户 界 面 ， 
下 一 小 节 会 给 出 一 个 界面 原型 ， 至 于 使 用 的 技术 ， 该 项 目 会 基于 大 家 
所 熟知 的 Spring 进一步 开发 。 


4.22 ”界面 原型 


里 然 根据 图 4-1 中 的 文字 揪 述 ， 我 们 已 经 了 解 了 用 户 注 册 服 务 所 涉 
及 的 内 容 ， 但 图 4-2 所 示 的 注册 页 面 更 加 直观 。 图 4-2 清 苇 地 标示 了 注册 
账户 所 需要 填写 的 各 个 字段 ， 还 展示 了 一 个 验证 码 图 片 ， 旁 边 还 有 一 
个 简单 的 链接 用 来 获取 新 的 验证 码 图 片 。 


注册 账户 | 
<1 G> $ @ 
注册 新 账户 


seo: [=] © 
= Eco 
we = 10 
sr me jo 


看 不 清 ? 
换 一 张 


图 4-2 ”注册 账户 服务 界面 原型 
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asi SO 


详细 了 解 了 这 个 简单 账户 注册 服务 的 需求 之 后 ， 就 能 勾勒 出 该 系 
统 对 外 的 接口 。 从 需求 用 例 中 可 以 看 到 ， 系 统 对 外 的 接口 包括 生成 验 
证 码 图 片 、 处 理 注册 请 求 、 激 活 账 户 以 及 处 理 登 录 等 。 图 4-3 描 述 了 系 
统 的 接口 。 


C) SignUpRequest 


AccountService 
+generateCaptchakeyQ) -displayName 
+generateCaptchalmage(captchakey: String) -password 
+ignUp{signUpRequest; SignUpRequest) -confirmPassword 
+activate(activationNumber: String) -captchakey 
Hoginfid: String, password: String) -captchavalue 


图 4-3 ”注册 账户 服务 系统 接口 


首先 需要 解释 的 是 generateCaptchaKey () 和 generateCaptchaImage 
O 方法 ， 对 于 Captcha 的 简单 解释 就 是 验证 码 。 每 个 Captcha 都 需要 有 
一 个 key， 根 据 这 个 key， 系 统 才能 得 到 对 应 的 验证 码 图 片 以 及 实际 
值 。 因 此 ，generateCaptchaKey () 会 生成 一 个 Captcha key， 使 用 这 个 
key 再 调用 generateImage () 方法 就 能 得 到 验证 码 图 片 。 验 证 码 的 key 以 
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SignUpRequest 包 含 了 注册 用 户 所 需要 的 信息 ， 包 括 ID、email、 显 
示 名 称 、 密 码 、 确 认 密 码 等 。 这 些 信息 伴随 着 Captcha key 和 Captcha 
value 构 成 了 一 个 注册 请 求 ，signUp O 方法 接收 SignUpRequest 对 象 ， 
进行 验证 ， 如 果 验 证 正确 ， 则 创建 一 个 未 被 激活 的 账户 ， 同 时 在 后 人 台 
也 需要 发 送 一 封 带 有 激活 链接 的 邮件 。 


activate () 方法 接收 一 个 激活 码 ， 查 找 对 应 的 账户 进行 激活 。 


账户 激活 之 后 ， 用 户 可 以 使 用 login () 方法 进行 登录 。 


4.3.2 ”模块 结构 


定义 了 系统 核心 的 接口 之 后 ， 基 于 功能 分 割 和 方便 复 用 的 原则 ， 
再 对 系统 进一步 进行 划分 。 这 里 基于 包 名 划分 模块 ， 这 也 是 在 Java 中 比 
较 常见 的 做 法 。 


也 许 你 会 觉得 为 如 此 简单 的 一 个 系统 (或 许 根 本 就 不 该 称 之 为 系 
) 划分 模块 有 点 小 题 大 做 了 ， 有 经 验 的 程序 员 根 本 不 需要 多 少 设计 
下 能 快速 完成 这 样 的 一 个 注册 功能 。 不 过 本 书 的 目的 不 在 这 个 功能 
喘 ， 我 们 需要 一 个 像 模 像样 的 、 有 很 多 模块 的 系统 来 演示 Maven 很 多 非 
常 酯 的 特性 ， 同 时 ， 双 不想 引入 一 个 拥有 成 十 上 万 行 代码 的 过 于 庞大 
的 系统 。 账 户 注 册 服 务 的 模块 划分 如 图 4-4 所 示 。 
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图 4-4 注册 账户 服务 包 疼 
现在 逐个 解释 一 下 各 个 模块 ( 包 ) 的 作用 : 


:com.juvenxu.mvnbook.account.service: 系统 的 核心 ， 它 封装 了 所 
有 下 层 细节 ， 对 外 暴露 简单 的 接口 。 这 实际 上 是 一 个 Facade 模 式 ， 了 解 
设计 模式 的 读者 应 该 能 马上 理解 。 


:com.juvenxu.mvnbook.account.web: 顾名思义 ， 该 模块 包含 所 有 与 
web 相 关 的 内 容 ， 包 括 可 能 的 JSP、Servlet、web.xml 等 ， 它 直接 依赖 于 


com.juvenxu.mvnbook.account.service 模 块 ， 使 用 其 提供 的 服务 。 


:com.juvenxu.mvnbook.account.persist: 处 理 账 户 信 息 的 持久 化 ， 包 
括 增 、 删 、 改 、 查 等 ， 根 据 实现 ， 可 以 基于 数据 库 或 者 文件 。 


:com.juvenxu.mvnbook.account.captcha: 处 理 验 证 码 的 key 生 成 、 图 
片 生成 以 及 验证 等 ， 这 里 需要 第 三 方 的 类 库 来 帮助 实现 这 些 功能 。 


:com.juvenxu.mvnbook.account.email: 处 理 邮 件 服务 的 配置 、 激 活 
邮件 的 编写 和 发 送 等 工作 。 


44 ”小 结 


到 目前 为 止 ， 我 们 已 经 了 解 了 账户 注册 服务 的 需求 、 大 概 的 界 
面 、 简 单 的 接口 设计 以 及 模块 的 职责 划分 ， 虽 然 我 们 没有 实际 编写 代 
码 ， 但 这 已 足够 文 持 本 书后 续 章 节 关 于 Maven 概 念 和 实践 的 描述 。 在 
下 面 的 章节 中 ， 这 个 简单 的 账户 注册 服务 将 得 以 一 步 步 地 实现 和 完 
善 ， 同 时 我 们 也 将 看 到 Maven 如 何 与 实际 项 目 结合 并 发 挥 目 己 的 功 
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正如 第 1 章 所 述 ，Maven 的 一 大 功能 是 管理 项 目 依赖 。 为 了 能 目 动 
化 地 解析 任何 一 个 Java 构 件 ，Maven 就 必须 将 它们 唯一 标识 ， 这 就 依 


赖 管理 的 确 层 基础 一 一 坐标 。 本 章 将 详细 分 析 Maven 坐 标的 作用 ， 解 
释 其 每 一 个 元 素 ; 在 此 基础 上 ， 再 介绍 如 何 配置 Maven， 以 及 相关 的 
经 验 和 技巧 ， 以 帮助 我 们 管理 项 目 依 赖 。 


5.1 何 为 Maven 侍 标 


关于 坐标 (Coordinate) ， 大 家 最 熟悉 的 定义 应 该 来 自 于 平面 几 
何 。 在 一 个 平面 坐标 系 中 ， 坐 标 (x, y) 表示 该 平面 上 与 x 轴 距离 为 
y， 与 y 轴 距离 为 x 的 一 点 ， 任 何 一 个 坐标 都 能 够 唯一 标识 该 平面 中 的 一 
点 。 


在 实际 生活 中 ， 我 们 也 可 以 将 地 址 看 成 是 一 种 坐标 。 省、 市 、 
区 、 街 道 等 一 系列 信息 同样 可 以 唯一 标识 城市 中 的 任 一 居住 地 址 和 工 
作 地 址 。 邮 局 和 快递 公司 正 是 基于 这 样 一 种 坐标 进行 日 党 工 作 的 。 


对 应 于 平面 中 的 点 和 城市 中 的 地 址 ，Maven 的 世界 中 拥有 数量 非常 
巨大 的 构件 ， 也 就 是 平时 用 的 一 些 jar、war 等 文件 。 在 Maven 为 这 些 构 
件 引 入 坐标 概念 之 前 ， 我 们 无 法 使 用 任何 一 种 方式 来 唯一 标识 所 有 这 
些 构件 。 因 此 ， 当 需要 用 到 Spring Framework 依 赖 的 时 候 ， 大 家 会 去 
Spring Framework 网 站 寻找 ， 当 需要 用 到 log4j 依 赖 的 时 候 ， 大 家 又 会 去 
Apache 网 站 寻找 。 又 因为 各 个 项 目的 网 站 风格 过 异 ， 大 量 的 时 间 人 花费 
在 了 搜索 、 浏 览 网 页 等 工作 上 面 。 没 有 统一 的 规范 、 统 一 的 法 则 ， 该 
工作 就 无 法 目 动 化 。 重 复 地 搜索 、 浏 览 网 页 和 下 载 类 似 的 jar 文 件 ， 这 
本 融 应 该 灾 给 机 器 来 做 。 而 机 器 工作 必须 基于 预定 义 的 规则 ，Maven 定 
义 了 这 样 一 组 规则 : 世界 上 任何 一 个 构件 都 可 以 使 用 Maven 坐 标 唯一 标 
识 ，Maven 坐 标的 元 素 包括 groupId、artifactId、version、packaging、 


classifier。 现 在 ， 只 要 我 们 提供 正确 的 坐标 元 素 ，Maven 就 能 找到 对 应 
的 构件 。 比 如 说 ， 当 需要 使 用 Java5 平 台 上 TestNG 的 5.8 版 本 时 ， 就 告诉 
Maven: “groupId=org.testng; artifactiId=testng; version=5.8; 
classifier=jdk15”，Maven 就 会 从 仓库 中 寻找 相应 的 构件 供 我 们 使 用 。 也 
许 你 会 奇怪 , “Maven 是 从 哪里 下 载 构件 的 呢 ? ”答案 其 实 很 简单 ， 
Maven 内 置 了 一 个 中 央 仓 库 的 地 址 (http://repol.maven.org/maven2) ， 
该 中 央 仓 库 包 含 了 世界 上 大 部 分 流行 的 开源 项 目 构件 ，Maven 会 在 需要 
的 时 候 去 那里 下 载 。 


在 我 们 开发 自己 项 目的 时 候 ， 也 需要 为 其 定义 适当 的 坐标 ， 这 是 
Maven 强 制 要 求 的 。 在 这 个 基础 上 ， 其 他 Maven 项 目 才 能 引用 该 项 目 生 
成 的 构件 ， 见 图 5-1。 


log4j:log4j:1.2.15 
org.springframework:spring-core:2.5 


org.apache.struts;struts-core:2. 1,0 


图 5-1 坐标 为 构件 引入 秩序 


5.2 坐标 详解 


Maven 坐 标 为 各 种 构件 引入 了 秩序 ， 任 何 一 个 构件 都 必须 明确 定 
义 自己 的 坐标 ， 而 一 组 Maven 坐 标 是 通过 一 些 元 素 定 义 的 ， 它 们 是 
groupld ` artifactId ` version ` packaging ` classifier 。 先 看 一 组 坐标 定 
X, WF: 


< groupId >org. sonatype. nexus < /groupId > 


<artifactId >nexus-indexer < fartifactId> 
<version >2.0.0 < AWersion> 
< packaging > jar < /~packaging > 


这 是 nexus-indexer 的 坐标 定义 ，nexus-indexer 是 一 个 对 Maven 仓 库 
编 得 索引 并 提供 搜索 功能 的 类 库 ， 它 是 Nexus 项 目的 一 个 子 模块 。 后 
会 详细 介绍 Nexus。 上 壕 代 码 厂 段 中 ， 其 坐标 分 别 为 groupId: 
org.sonatype.nexus ` artifactId: nexus-indexer ` version: 2.0.0 ` 


packaging: jar， 没 有 classifier。 下 面 详细 解释 一 下 各 个 坐标 元 素 : 


‘groupld: 定义 当前 Maven 项 目 隶属 的 实际 项 目 。 首 先 ，Maven 项 
目 和 实际 项 目 不 一 定 是 一 对 一 的 关系 。 比 如 SpringFramework 这 一 实际 
项 目 ， 其 对 应 的 Maven 项 目 会 有 很 多 ， 如 spring-core ` spring-context 
等 。 这 是 由 于 Maven 中 模块 的 概念 ， 因 此 ， 一 个 实际 项 目 往 往 会 被 划 
分 成 很 多 模块 。 其 次 ，groupId 不 应 该 对 应 项 目 隶 属 的 组 织 或 公司 。 原 
因 很 简单 ， 一 个 组 织 下 会 有 很 多 实际 项 目 ， 如 果 groupId 只 定义 到 组 织 


级 别 ， 而 后 面 我 们 会 看 到 ，artifactId 只 能 定义 Maven 项 目 RIR) ， 那 
么 实际 项 目 这 个 层 将 难以 定义 。 最 后 ，groupId 的 表示 方式 与 Java 包 名 
的 表示 方式 类 似 ， 通 常 与 域名 反问 一 一 对 应 。 上 例 中 ，groupId 为 


org.sonatype.nexus, ，org.sonatype 表 示 Sonatype 公 司 建 立 的 一 个 非 僵 利 


性 组 织 ，nexus 表 示 Nexus 这 一 实际 项 目 ， 该 groupId 与 域名 


nexus.Sonatype.org 对 心 。 


“artifactId: 该 元 素 定 义 实际 项 目 中 的 一 个 Maven 项 目 (模块 ) ， 
推荐 的 做 法 是 使 用 实际 项 目 名 称 作为 artifactId 的 前 弘 。 比 如 上 例 中 的 
artifactId 十 nexus-indexer， 使 用 了 实际 项 目 名 nexus 作 为 前 级， 这 样 做 
的 好 处 是 方便 寻找 实际 构件 。 在 默认 情况 下 ，Maven 生 成 的 构件 ， 其 
文件 名 会 以 artifactId 作 为 开头 ， 如 nexus-indexer-2.0.0.jar， 使 用 实际 项 
日 名 称 作为 前 缀 之后， 就 能 方便 从 一 个 lib 文 件 夹 中 找到 某 个 项 目的 一 
组 构件 。 考 虚 有 5 个 项 目 ， 每 个 项 目 都 有 一 个 core 模 块 ， 如 果 没 有 前 
缀 ， 我 们 会 看 到 很 多 core-1.2.jar 这 样 的 文件 ， 加 上 实际 项 目 名 前 缀 之 
后 ， 便 能 很 容易 区 分 foo-core-1.2.jar ` bar-core-1.2.jar...... 


‘version: 该 元 素 定义 Maven 项 目 当 前 所 处 的 版 本 ， 如 上 例 中 
nexus-indexer 的 版 本 是 2.0.0。 需 要 注意 的 是 ，Maven 定 义 了 一 套 完 成 的 
版 本 规范 ， 以 及 快照 (SNAPSHOT) 的 概念 。 第 13 章 会 详细 讨论 版 本 
管理 内 容 。 


‘packaging: 该 元 素 定 义 Maven 项 目的 打包 方式 。 首 先 ， 打 包 方 式 
通常 与 所 生成 构件 的 文件 扩展 名 对 应 ， 如 上 例 中 packaging 为 jar， 最 终 
的 文件 名 为 nexus-indexer-2.0.0.jar， 而 使 用 war 打 包 方 式 的 Maven 项 
日 ， 最 终生 成 的 构件 会 有 一 个 .war 文 件 ， 不 过 这 不 是 绝对 的 。 其 次 ， 
打包 方式 会 影响 到 构建 的 生命 周期 ， 比 如 jar 打 包 和 war 打 包 会 使 用 不 
同 的 命令 。 最 后 ， 当 不 定义 packaging 的 时 候 ，Maven 会 使 用 默认 值 


jar ° 


‘classifier: 该 元 素 用 来 帮助 定义 构建 输出 的 一 些 附 属 构 件 。 附 属 
构件 与 主 构件 对 应 ， 如 上 例 中 的 主 构件 是 nexus-indexer-2.0.0.jar， 该 项 
目 可 能 还 会 通过 使 用 一 些 插 件 生 成 如 nexus-indexer-2.0.0-javadoc.jar ` 
nexus-indexer-2.0.0-sources.jar 这 样 一 些 附 属 构 件 ， 其 包含 了 Java 文 档 和 
源 代码 。 这 时 候 ，javadoc 和 sources 就 是 这 两 个 附属 构件 的 classifier 。 
这 样 ， 附 属 构 件 也 就 拥有 了 自己 唯一 的 坐标 。 还 有 一 个 天 于 classifier 
的 典型 例子 是 TestNG，TestNG 的 主 构件 是 基于 Java 1.4 平 台 的 ， 而 它 又 
提供 了 一 个 classifier 为 jdk5 的 附属 构件 。 注 意 ， 不 能 直接 定义 项 目的 
classifier， 因 为 附属 构件 不 是 项 目 直接 默认 生成 的 ， 而 是 由 附加 的 插 
件 帮 助 生 成 。 


上 壕 5 个 元 素 中 ，groupId、artifactId、version 是 必须 定义 的 ， 
packaging 是 可 选 的 (默认 为 jar) ， 而 classifier 是 不 能 直接 定义 的 。 


同时 ， 项 目 构件 的 文件 名 是 与 坐标 相对 应 的 ， 一 般 的 规则 为 
artifactId-version |-classifier| .packaging, |-classifier| 表示 可 选 。 比 
如 上 例 nexus-indexer 的 主 构件 为 nexus-indexer-2.0.0.jar， 附 属 构 件 有 
nexus-indexer-2.0.0-javadoc.jar。 这 里 还 要 强调 的 一 点 是 ，packaging 并 
非 一 定 与 构件 扩展 名 对 应 ， 比 如 packaging 为 maven-plugin 的 构件 扩展 
名 为 jar。 

此 外 ，Maven 仓 库 的 布局 也 是 基于 Maven 坐 标 ， 这 一 点 会 在 介绍 
Maven 仓 库 的 时 候 详 细 解 释 。 

理解 请 楚 城 市 中 地 址 的 定义 方式 后 ， 邮 递 员 就 能 够 开始 工作 了 

同样 地 ， 理 解 清楚 Maven 坐 标 之 后 ， 我 们 就 能 开始 讨论 Maven 的 依赖 
管理 了 。 


5.3 account-email 


在 详细 讨论 Maven 依 赖 之 前 ， 先 稍微 回顾 一 下 上 一 革 提 到 的 背景 
案例 。 案 例 中 有 一 个 email 模 块 负 贡 发 送 账户 激活 的 电子 邮件 ， 本 市 束 
详细 阐述 该 模块 的 实现 ， 包 括 POM 配 置 、 主 代码 和 测试 代码 。 由 于 该 
背景 案例 的 实现 是 基于 Spring Framework， 因 此 还 会 涉及 相关 的 Spring 
配置 。 


5.3.1 account-emailf‘JPOM 


首先 看 一 下 该 模块 的 POM， 见 代码 清单 5-1。 
代码 清单 5-1 account-email 的 POM 


<project xmins = "http://maven. apache. org /POMA.0.0" 
xmlns :xsi =http://www.w3.org/2001 /XMLSchema-instance 
xsi:schemaLocation = "http://maven. apache. org/POM/4.0.0 
http: //maven. apache. org /maven-v4_0_0.xsd"> 


<modelVersion >4.0.0 < /modelVersion > 

<groupid > com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-email < /artifactId> 

<name >Account Email < /name > 

<version >1.0.0-SNAPSHOT < /version > 


< dependencies > 

< dependency > 
<groupld >org. springframework < /grouplId > 
<artifactId >spring-core < /artifactId> 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
< groupId >org. springframework < /groupId > 
<artifactId >spring-beans < /artifactId> 
<version>2.5.6< /version > 

< /dependency > 

< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId > Spring-Context < /artifactid> 
<version >2,5.6 </version> 

</dependency > 

< dependency > 
< groupiad > org. springframework < /groupId > 
<artifactId >spring-context-support < /artifactId> 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
<groupld > javax. mail < /groupId> 
<artifactid>mail < /artifactid> 
<version >1.4.1</version> 

< /dependency > 

< dependency > 
<groupId > junit < /groupId > 
<artifactid>junit < /artifactId> 
<version >4.7 < /version > 
< scope >test < /scope > 

< /dependency > 

<dependency > 
<groupId >com. icegreen < /groupId > 
<artifactId >greenmail < /artifactiId> 
<version >1.3.1b</version > 
< scope >test < /scope > 

< /dependency > 

< /dependencies > 


<build> 
<plugins > 
<plugin > 
<groupid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-compiler-plugin < /artifactId> 
< configuration > 
< source >1.5 < /source > 
<target >1.5 < /target > 
< /configuration > 


先 观察 该 项 目 模块 的 坐标 ，groupId: 
com.juvenxu.mvnbook.account; artifactId: account-email; version: 
1.0.0-SNAPSHOT。 由 于 该 模块 属于 账户 注册 服务 项 目的 一 部 分 ， 
此 ， 其 groupId 对 应 了 account 项 目 。 紧 接着 ， 该 模块 的 artifactId 仍 然 以 
account 作 为 前 级 ， 以 方便 区 分 其 他 项 目的 构建 。 最 后 ，1.0.0- 
SNAPSHOT 表 示 该 版 本 处 于 开发 中 ， 还 不 稳定 。 


再 看 dependencies 元 素 ， 其 包含 了 多 个 dependency 子 元 素 ， 这 是 
POM 中 定义 项 目 依赖 的 位 置 。 以 第 一 个 依赖 为 例 ， 其 groupId: 
artifactId: version 为 org.springframework: spring-core: 2.5.6， 这 便 是 依 
赖 的 坐标 ， 任 何 一 个 Maven 项 目 都 需要 定义 自己 的 坐标 ， 当 这 个 Maven 
项 目 成 为 其 他 Maven 项 目的 依赖 的 时 候 ， 这 组 坐标 瓯 体现 了 其 价值 。 本 
例 中 的 spring-core， 以 及 后 面 的 spring-beans ` spring-context ` spring- 
context-support 是 Spring Framework 实 现 依 赖 注入 等 功能 必要 的 构件 ， 由 
于 本 书 的 关注 点 在 于 Maven， 只 会 涉及 人 简单 的 Spring Framework 的 使 
用 ， 不 会 详细 解释 Spring Framework 的 用 法 ， 如 果 读 者 有 不 清楚 的 地 
方 ， 请 参阅 Spring Framework 相 天 的 文档 。 


在 spring-context-support 之 后 ， 有 一 个 依赖 为 javax.mail: mail: 
1.4.1， 这 是 实现 发 送 必 须 的 类 库 。 


紧 接 着 的 依赖 为 junit:， junit: 4.7，JUnit 是 Java 社 区 事实 上 的 单元 测 
试 标准 ， 详 细 信息 请 参阅 http:/www.junitorg/， 这 个 依赖 特殊 的 地 方 在 
于 一 个 值 为 test 的 scope 子 元 素 ，scope 用 来 定义 依赖 范围 。 这 里 读者 暂 
时 只 需要 了 解 当 依赖 范围 是 test 的 时 候 ， 该 依赖 只 会 被 加 入 到 测试 代码 
的 classpath 中 。 也 就 是 说 ， 对 于 项 目 主 代 码 ， 该 依赖 是 没有 任何 作用 
的 。JUnit 是 单元 测试 框架 ， 只 有 在 测试 的 时 候 才 需要 ， 因 此 使 用 该 依 
赖 范围 。 


随后 的 依赖 是 com.icegreen: greenmail: 1.3.1b， 其 依赖 范围 同样 为 
test。 这 时 也 许 你 已 经 猜 到 ， 该 依赖 同样 只 服务 于 测试 目的 ，GreenMail 
是 开源 的 邮件 服务 测试 套件 ，account-email 模 块 使 用 该 套件 来 测试 邮件 
的 发 送 。 关 于 GreenMail 的 详细 信息 可 访问 


http://www.icegreen.com/greenmail/ ° 


最 后 ，POM 中 有 一 段 关 于 maven-compiler-plugin 的 配置 ， 其 目的 是 
开启 Java 5 的 支持 ， 第 3 章 已 经 对 该 配置 做 过 解释 ， 这 里 不 再 歼 述 。 


5.3.2 account-emailH)=$ (tA3 


account-email 项 目 Java 主 代码 位 于 src/main/java， 资 源 文 件 (SE 


Java) 位 于 src/main/resources 有 目录 下 。 
account-email 只 有 一 个 很 测 单 的 接口 ， 见 代码 清单 5-2 。 
代码 清单 5-2 AccountEmailService.java 


package com. juvenxu.mvnbook. account. email; 
public interface AccountEmailService 


roid sendMail ( String to, String subject, String htmlText ) 


throws AccountEmailException; 


sendMail () 方法 用 来 发 送 html 格 式 的 邮件 ，to 为 接收 地 址 ， 
subject 为 邮件 主题 ，htmlText 为 邮件 内 容 ， 如 有 果 发 送 邮 件 出 错 ， 则 抛 出 


AccountEmailException# 7 ° 
对 应 于 该 接口 的 实现 见 代码 清单 5-3。 


代码 清单 5-3 AccountEmailServiceImpl.java 


package com. juvenxu.mvnbook. account. email; 


import javax.mail.MessagingException; 
import javax.mail, internet.MimeMessage; 


import org. springframework.mail.javamail.JavaMailSender; 
import org. springframework. mail. javamail,MimeMessageHelper; 


public class AccountEmailServicelImpl 
implements AccountEmailService 

{ 
private JavaMailSender javaMailSender; 


private String systemEmail; 


public void sendMail ( String to, String subject, String htmlText ) 
throws AccountEmailException 
{ 
try 
{ 
MimeMessage msg = javaMailSender. createMimeMessage (); 
MimeMessageHelper msgHelper = new MimeMessageHelper (msg }; 


msgHelper.setFrom( systemEmail ); 
msgHelper.setTo( to ); 
msgHelper.setSubject ( subject ); 
msgHelper. setText ( htmlText, true }; 


javaMailSender. send ( msg ); 


} 
catch ( MessagingExceptione ) 
{ 
throw new AccountEmailException( "Faild to send mail.",e); 
} 


} 


public JavaMailSender getJavaMailSender () 
{ 


首先 ， 该 AccountEmailServiceImpl 类 有 一 个 私有 字段 
javaMailSender， 该 字段 的 类 型 
org.Springframework.mail.javamail.JavaMailSender 是 来 目 于 Spring 
Framework 的 帮助 简化 邮件 发 送 的 工具 类 库 ， 对 应 于 该 字段 有 一 组 
getter () 和 setter () 方法 ， 它 们 用 来 帮助 实现 依赖 注入 。 本 节 随 后 会 
讲述 Spring Framework 依 赖 注入 相关 的 配置 。 


在 sendMail () 的 方法 实现 中 ， 首 先 使 用 javaMailSender 创 建 一 个 
MimeMessage， 该 msg 对 应 了 将 要 发 送 的 邮件 。 接 着 使 用 
MimeMessageHelper 帮 助 设置 该 邮件 的 发 送 地 址 、 收 件 地 址 、 主 题 以 及 
内 容 ，msgHelper.setText (htmlText, true) 中 的 true 表 示 邮 件 的 内 容 为 
html 格 式 。 最 后 ， 使 用 javaMailSender 发 送 该 邮件 ， 如 果 发 送出 错 ， 则 
捕捉 MessageException 异 常 ， 包 装 后 再 抛 出 该 模块 自己 定义 的 


AccountEmailException 异 常 。 


ix Eavat ths FIA a EARS ee eS, ihm T Spring 
Framework 的 依赖 注入 ， 这 些 配 置 都 通过 外 部 的 配置 注入 到 了 
javaMailSender 中 ， 相 关 配 置信 息 都 在 src/main/resources/account- 
email.xml 这 个 配置 文件 中 ， 见 代码 清单 5-4。 


代码 清单 5-4。” account-email.xml 


<?xml version = "1.0" encoding = "UTF-8"?> 
<beans xmlins = tht bes ://www. springframework. org/schema/beans" 
xmins :xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http://www. springframework. a ng /beans 
http://www. springframework. org/schema/beans /spring-beans-2.5.xsd"> 


<bean id= "propertyConfigurer" 
class = "org. springframework. beans. factory. config. PropertyPlaceholder — 
Configurer" > 
<property name = "location" value = "classpath:service. properties" /> 
< /bean > 


<bean id = "javaMailSender" class = "org. springframework. mail. javamail.JavaMail- 
SenderiImp1" > 


<property name = "protocol" value =" $ femail.protocol}" /> 
<property name = "host" value =" $ {email.host}" /> 
<property name = "port" value =" $ {email.port}" /> 
<property name = "username" value =" $ {email.username}" /> 
<property name = "password" value =" $ {email.password}" /> 


<property name = "javaMailProperties" > 
< props > 
<prop key = "mail. $ femail.protocol}.auth"> $ {email. auth} < /prop > 
< /props > 
< /property > 
< /bean > 


<bean id = "“accountEmailService" 
class = "com. juvenxu. mvnbook. account. email.AccountEmailServiceImp1" > 
<property name = "javaMailSender" ref = "javaMailSender" /> 
<property name = "systemEmail" value =" $ {email.systemEmail}" /> 
< /bean > 
< /beans > 


Spring Framework 会 使 用 该 XML 配置 创建 ApplicationContext， 以 实 
现 依赖 注入 。 该 配置 文件 定义 了 一 些 bean， 基 本 对 应 了 Java 程 序 中 的 对 


象 。 首 先 解释 下 id 为 propertyConfigurer 的 bean， 其 实现 为 
org.springframework.beans.factory.config.PropertyPlaceholderConfigurer , 
这 是 Spring Framework 中 用 来 帮助 载 入 properties 文 件 的 组 件 。 这 里 定义 
location 的 值 为 casspath: account-email.properties， 表 示 从 classpath 的 根 
路 径 下 载 入 名 为 account-email.properties 文 件 中 的 属性 。 


接着 定义 id 为 javaMailSender 的 bean， 其 实现 为 
org.springframework.mail.javamail JavaMail-Senderlmpl, iX EREZA 
RAPER SS as EE, GLa > mO + EDL > APE > MS, ze 
否 需要 认证 等 属性 。 这 段 配置 还 使 用 了 Spring Framework 的 属性 引用 ， 
比如 host 的 值 为 $ {email.host} ， 之 前 定义 propertyConfigurer 的 作用 残 在 
于 此 。 这 么 做 可 以 将 邮件 服务 器 相关 的 配置 分 离 到 外 部 的 properties 文 
件 中 ， 比 如 可 以 定义 这 样 一 个 properties 文 件 ， 配 置 javaMailSender 使 用 


gmail: 
email. protocol =smtps 
email.host =smtp. gmail.com 
email.port =465 
email.username =your-id@ gmail.cor 
email. password =your-password 
email.auth =true 


email.systemEmail =your-id@ juvenxu. com 


这 样 ，javaMailSender 实 际 使 用 的 protocol 束 会 成 为 smtps，host 会 成 
为 smtp.gmailcom， 同 理 还 有 port、username 等 其 他 属性 。 


最 后 一 个 bean 是 accountEmailService， 对 应 了 之 前 描述 的 
com.juvenxu.mvnbook.account.email.AccountEmailServiceImp1， 配 置 中 
将 另外 一 个 bean javaMailSender 注 入 ， 使 其 成 为 该 类 javaMailSender 字 上 段 
的 值 。 


jt Spring Framework 相 天 的 配置 ， 这 里 不 再 进一步 深入 ， 读 
者 如 果 有 不 是 很 理解 的 地 方 ， 请 查询 Spring Framework 相 关 文 档 。 


5.3.3 accountemail 的 测试 代码 


测试 相关 的 Java 代 码 位 于 src/test/java 目 录 ， 相 关 的 资源 文件 则 位 


于 src/test/resources 目 了 未 。 


该 模块 需要 测试 的 只 有 一 个 AccountEmailService.sendMail () 接 
口 。 为 此 ， 需 要 配置 并 启动 一 个 测试 使 用 的 邮件 服务 器 ， 然 后 提供 对 
应 的 properties 配 置 文件 供 Spring Framework 载 入 以 配置 程序 。 准 备 就 绪 
之 后 ， 调 用 该 接口 发 送 邮 件 ， 然 后 检查 邮件 是 否 发 送 正确 。 最 后 ， 关 
闭 测 试 邮件 服务 器 ， 见 代码 清单 5-5 。 


代码 清单 5-5 AccountEmailServiceTest.java 


package com. juvenxu.mvnbook. account. email; 
import static junit. framework. Assert. assertEquals; 
import javax.mail. Message; 


import org. junit. After; 

import org. junit. Before; 

import org. junit. Test; 

import org. springframework. context. ApplicationContext; 

import org. springframework. context. support. ClassPathXmlApplicationContext; 


import com. icegreen. greenmail.util.GreenMail; 
import com. icegreen. greenmail.util.GreenMailUril; 
import com. icegreen. greenmail-util.ServerSetup; 


public class AccountEmailServiceTest 
{ 
private GreenMail greenMail; 


@ Before 
public void startMailServer () 
throws Exception 


{ 
greenMail = new GreenMail ( ServerSetup. SMTP ); 
greenMail.setUser( "test@ juvenxu.com", "123456" }; 
greenMail. start (}; 

} 

@ Test 


public void testSendMail () 
throws Exception 
{ 
ApplicationContext ctx = new ClassPathXmlApplicationContext ( “account- 
email.xmi* ); 
AccountEmailService accountEmailService = {AccountEmailService ) 
etx.getBean{ "“accountEmailService" ); 


String subject = "Test Subject"; 
String htmlText = *<h3 >Test < /h3 >”; 


ja 
1 bj htm ae 
greenMail.waitForincomingEmail (2000, 1 }; 
í age [] msgs enMa yetReceivedMessages (); 
sertEqu 3(1,msqs. length }; 
ssertEquals( subject, msas[0].getSubject () ); 
rtEd (htmlText, GreenMailUtil. getBody { msgs [0] }.trim{) ); 
4 After 
publi id st 1 r 
r Except 


这 里 使 用 GreenMail 作 为 测试 邮件 服务 器 ， 在 startMailServer () 
中 ， 基 于 SMTP 协 议 初始 化 GreenMail， 然 后 创建 一 个 邮件 账户 并 启动 
邮件 服务 ， 该 服务 默认 会 监听 25 端 口 。 如 果 你 的 机 器 已 经 有 程序 使 用 
该 端口 ， 请 配置 自 定义 的 ServerSetup 实 例 使 用 其 他 端口 。 
startMailServer () 方法 使 用 了 @before 标 注 ， 表 示 该 方法 会 先 于 测试 
方法 (@test) 之 前 执行 。 


对 应 于 startMailServer () ， 该 测试 还 有 一 个 stopMailServer () X 
法 ， 标 注 @After 表 示 执 行 测试 方法 之 后 会 调用 该 方法 ， 俘 止 GreenMail 
的 邮件 服务 。 


代码 的 重点 在 于 使 用 了 @Test 标 注 的 testSendMail () 方法 ， 该 方 
法 首先 会 根据 classpath 路 径 中 的 account-email.xml 配 置 创建 一 个 Spring 
Framework 的 ApplicationContext， 然 后 从 这 个 ctx 中 获取 需要 测试 的 id 为 
accountEmailService 的 bean， 并 转换 成 AccountEmailService 接 口 ， 针 对 


接口 测试 是 一 个 单元 测试 的 最 佳 实践 。 得 到 了 AccountEmailService 之 
后 ， 就 能 调用 其 sendMail () 方法 发 送 电子 邮件 。 当 然 ， 这 个 时 候 不 
能 起 了 邮件 服务 妖 的 配置 ， 其 位 于 src/test/resources/service.properties: 


nail. protocol = smtr 

email. hos localhc 

email.port =25 

email.us ame st@ juvenxu. com 
mail.password =123456 

email.ai =tru 
nail. sy nEmail =your- a juvenxu. n 


这 段 配置 与 之 前 GreenMail 的 配置 对 应 ， 使 用 了 smtp 协 议 ， 使 用 本 
机 的 25 病 口 ， 并 有 用 户 名 、 蜜 码 等 认证 配置 


回 到 测试 方法 中 ， 邮 件 发 送 完毕 后 ， 再 使 用 GreenMail 进 行 检 查 。 
greenMail.waitForIncomingEmail (2000, 1) 表示 接收 一 封 邮件 ， 最 多 
等 待 2 秒 。 由 于 GreenMail 服 务 完全 基于 内 存 ， 实 际 情 况 下 基本 不 会 超 
过 2 秒 。 随 后 的 几 行 代 码 读 取 收 到 的 邮件 ， 检 查 邮 件 的 数目 以 及 第 一 封 
邮件 的 主题 和 内 容 。 


这 时 ， 可 以 运行 mvn clean test 执 行 测 试 ，Maven 会 编译 主 代码 和 
测试 代码 ， 并 执行 测试 ， 报 告 一 个 测试 得 以 正确 执行 ， 构 建成 功 。 


5.3.4 构建 account-email 


使 用 mvn clean install 构 建 account-email，Maven 会 根据 POM 配 置 自 
动 下 载 所 需要 的 依赖 构件 ， 执 行 编译 、 测 试 、 打 包 等 工作 ， 最 后 将 项 
目 生成 的 构件 account-email-1.0.0-SNAPSHOTjar 安 装 到 本 地 仓库 中 。 
这 时 ， 该 模块 就 能 供 其 他 Maven 项 目 使 用 了 ° 


5.4 依赖 的 配置 


5.3.1 市 已 经 罗列 了 一 些 简 单 的 依赖 配置 ， 读 者 可 以 看 到 依赖 会 有 
基本 的 groupId、artifactId 和 version 等 元 素 组 成 。 其 实 一 个 依赖 声明 可 
以 包含 如 下 的 一 些 元 素 : 


<project > 


< dependencies > 
< dependency > 
<groupId >... < /groupId > 
<artifactId >.. </artifactiId> 
<version>.. < /version > 
<type >... < /type > 
< scope >... < /scope > 
<optional >.. < /optional > 
<exclusions > 
<exclusion > 


< /exclusion > 


< f/exclusions > 
< /dependency > 


< /dependencies > 


< /project > 


根 元 素 project 下 的 dependencies 可 以 包含 一 个 或 者 多 个 dependency 
元 素 ， 以 声明 一 个 或 者 多 个 项 目 依赖 。 每 个 依赖 可 以 包含 的 元 素 有 : 


-groupId、artifactId 和 version: 依赖 的 基本 坐标 ， 对 于 任何 一 个 依 
赖 来 说 ， 基 本 坐标 是 最 重要 的 ，Maven 根 据 坐 标 才 能 找到 需要 的 依 


R o 


‘type: 依赖 的 类 型 ， 对 应 于 项 目 坐标 定义 的 packaging。 大 部 分 情 
况 下， 该 元 素 不 必 声 明 ， 其 默认 值 为 jar 。 


‘scope: 依赖 的 范围 ， 见 5.5 字 。 
‘optional: 标记 依赖 是 否 可 选 ， 见 5.8 字 。 
.exclusions: 用 来 排除 传递 性 依赖 ， 见 5.9.1 广 。 


大 部 分 依赖 声明 只 包 侣 基本 坐标 ， 然 而 在 一 些 特殊 情况 下 ， 其 他 
元 素 至 关 重 要 。 本 章 下 面 的 小 节 会 对 它们 的 原理 和 使 用 方式 详细 介 


绍 。 
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首先 需要 知道 ，Maven 在 编译 项 目 主 代码 的 时 候 需要 使 用 一 套 
classpath。 在 上 例 中 ， 编 译 项 目 主 代码 的 时 候 需要 用 到 spring-core， 该 
文件 以 依赖 的 方式 被 引入 到 classpath 中 。 其 次 ，Maven 在 编译 和 执行 测 
试 的 时 候 会 使 用 另外 一 套 classpath。 上 例 中 的 JUnit 就 是 一 个 很 好 的 例 
子 ， 该 文件 也 以 依赖 的 方式 引入 到 测试 使 用 的 classpath 中 ， 不 同 的 是 这 
里 的 依赖 范围 症 test。 最 后 ， 实 际 运 行 Maven 项 目的 时 候 ， 义 会 使 用 一 
套 classpath， 上 例 中 的 spring-core 需 要 在 该 classpath 中 ， 而 JUnit 则 不 需 
要 o 


依赖 范围 就 是 用 来 控制 依赖 与 这 三 种 dasspath (编译 classpath、 测 
斌 classpath、 运 行 classpath) 的 关系 ，Maven 有 以 下 几 种 依赖 范围 : 


‘compile: 编译 依赖 范围 。 如 条 没 有 指定 ， 束 会 玖 认 使 用 该 依赖 艺 
o 使 用 此 依赖 范围 的 Maven 依 赖 ， 对 于 编译 、 测 试 、 运 行 三 种 
classpath 都 有 效 。 典 型 的 例子 是 spring-core， 在 编译 、 测 试 和 运行 的 时 
候 都 需要 使 用 该 依赖 。 


‘test: 测试 依赖 范围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 只 对 于 测试 
classpath 有 效 ， 在 编译 主 代码 或 者 运行 项 目的 使 用 时 将 无 法 使 用 此 类 依 
赖 。 典 型 的 例子 是 JUnit， 它 只 有 在 编译 测试 代码 及 运行 测试 的 时 候 才 


需要 。 


‘provided: 已 提供 依赖 范围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 对 于 
编译 和 测试 classpath 有 效 ， 但 在 运行 时 无 效 。 典 型 的 例子 是 servlet-api， 
编译 和 测试 项 目的 时 候 需 要 该 依赖 ， 但 在 运行 项 目的 时 候 ， 由 于 容 融 
已 经 提供 ， 就 不 需要 Maven 重 复 地 引入 一 遍 。 


runtime: 运行 时 依赖 范围 。 使 用 此 依赖 范围 的 Maven 依 赖 ， 对 于 
测试 和 运行 classpath 有 效 ， 但 在 编译 主 代码 时 无 效 。 上 典型 的 例子 是 
JDBC 了 驱动 实现 ， 项 目 主 代码 的 编译 只 需要 JDK 提 供 的 JDBC 接 口 ， 只 
在 执行 测试 或 者 运行 项 目的 时 候 才 需要 实现 上 述 接 口 的 具体 JDBC 驱 
动 。 


‘system: 系统 依赖 范围 。 该 依赖 与 三 种 classpath 的 关系 ， 和 
provided 依 赖 范 围 完全 一 致 。 但 是 ， 使 用 system 范 围 的 依赖 时 必须 通过 
systemPath 元 素 显 式 地 指定 依赖 文件 的 路 径 。 由 于 此 类 依赖 不 是 通过 
Maven 仓 库 解 析 的 ， 而 且 往 往 与 本 机 系统 绑 定 ， 可 能 造成 构建 的 不 可 移 
植 ， 因 此 应 该 谨慎 使 用 。systemPath 元 素 可 以 引用 环境 变量 ， 如 : 


<dependency > 
<groupld > javax. sal < /groupId > 
<artifactId > jdbc-stdext < /artifactId > 
<version >2.0 <version> 


< scope > system < /scope > 
<systemPath > $ (java. home}/lib/rt. jar < /systemPath > 
< /dependency > 
‘import (Maven 2.0.9 及 以 上 ) : 导入 依赖 范围 。 该 依赖 范围 不 会 
对 三 种 classpath 产 生 实 际 的 影响 ， 本 书 将 在 8.3.3 志 介绍 Maven 依 赖 和 
dependencyManagement 的 时 候 详 细 介 绍 此 依赖 范围 。 


上 述 除 import 以 外 的 各 种 依赖 范围 与 三 种 classpath 的 关系 如 表 5-1 所 


修 ° 


表 5-1 依赖 范围 与 classpath 的 天 系 


依赖 范围 对 于 编译 对 于 测试 对 于 运行 时 


(Scope) classpath 有 效 classpath 有 效 classpath 有 效 例子 
compile Y Y Y spring-core 
test — Y = JUnit 
provided Y Y — servlet-api 
runtime 一 Y Y JDBC 驱动 实现 
= 本 地 的 ，Maven 仓库 之 外 


的 类 库 文件 


5.6 FEER 


5.6.1 (ARTE 


考虑 一 个 基于 Spring Framework 的 项 目 ， 如 果 不 使 用 Maven， 那 么 
在 项 目 中 就 需要 手动 下 载 相关 依赖 。 由 于 Spring Framework 又 会 依赖 于 
其 他 开源 类 库 ， 因 此 实际 中 往往 会 下 载 一 个 很 大 的 如 spring-framework- 
2.5.6-with-dependencies.zip 的 包 ， 这 里 包含 了 所 有 Spring Framework 的 jar 
包 ， 以 及 所 有 它 依赖 的 其 他 jar 包 。 这 么 做 往往 就 3 引入 了 很 多 不 必要 的 
依赖 。 另 一 种 做 法 是 只 下 载 spring-framework-2.5.6.zip 这 样 一 个 包 ， 这 
里 不 包含 其 他 相关 依赖 ， 到 实际 使 用 的 时 候 ， 再 根据 出 错 信息 ， 或 者 
查询 相关 文档 ， 加 入 需要 的 其 他 依赖 。 很 显然 ， 这 也 是 一 件 非常 麻 和 烦 
的 事情 。 


Maven 的 传递 性 依赖 机 制 可 以 很 好 地 解决 这 一 问题 。 以 account- 
email 项 目 为 例 ， 该 项 目 有 一 个 org.springframework: spring-core: 2.5.6 
的 依赖 ， 而 实际 上 spring-core 也 有 它 自己 的 依赖 ， 我 们 可 以 直接 访问 位 
于 中 央 仓 库 的 该 构件 的 POM: 
http://repo1.maven.org/maven2/org/springframework/spring- 


core/2.5.6/spring-core-2.5.6.pom。 该 文件 包含 了 一 个 commons-logging 依 
赖 ， 见 代码 清单 5-6。 


代码 清单 5-6  spring-coref‘/commons-logging {K ii 


< dependency > 


<groupId >commons-—logging < /groupId > 


<artifactId >commons-logging < /artifactId> 
‘version >1.1.1 < /version > 
< /dependency > 


该 依赖 没有 声明 依赖 范围 ， 那 么 其 依赖 范围 就 是 默认 的 compile ° 
同时 回顾 一 下 account-email，spring-core 的 依赖 范围 也 是 compile ° 


account-mail 有 一 个 compile 范 围 的 spring-core 依 赖 ，spring-core 有 一 
‘compileyz Fs] #Jcommons-logging Kk #i, HbA commons-logging#tA ABN 
account-email 的 compile 范 围 依 赖 ，commons-logging 是 account-email 的 一 


个 传递 性 依赖 ， 如 图 5-2 所 示 。 


ae 
p ma pp jg 
ey es 


account-email -———* spring-core “一 一 commons-logging 
一 一 一 


图 5-2 ”传递 性 依赖 


有 了 传递 性 依赖 机 制 ， 在 使 用 Spring Framework 的 时 候 就 不 用 去 考 
虚 它 依赖 了 什么 ， 也 不 用 担心 引入 多 余 的 依赖 。Maven 会 解析 各 个 直接 
依赖 的 POM， 将 那些 必要 的 间接 依赖 ， 以 传递 性 依赖 的 形式 引入 到 当 
前 的 项 目 中 。 


5.6.2 fee PERO AT HORE FE] 


依赖 范围 不 仅 可 以 控制 依赖 与 三 种 classpath 的 天 系 ， 还 对 传递 性 依 
赖 产生 有 影响。 上 面 的 例子 中 ，account-email 对 于 spring-core 的 依赖 范围 
是 compile，spring-core 对 于 commons-logging 的 依赖 范围 是 compile， 那 
么 account-email 对 于 commons-logging 这 一 传递 性 依赖 的 范围 也 就 是 
compile。 假 设 A 依 赖 于 B，B 依 赖 于 C， 我 们 说 A 对 于 B 是 第 一 直接 依 
赖 ，B 对 于 C 是 第 二 直接 依赖 ，A 对 于 C 是 传递 性 依赖 。 第 一 直接 依赖 的 
范围 和 第 二 直接 依赖 的 范围 决定 了 传递 性 依赖 的 范围 ， 如 表 5-2 所 示 ， 

最 左边 一 行 表示 第 一 直接 依赖 范围 ， 最 上 面 一 行 表示 第 二 直接 依赖 范 
， 中 间 的 交 久 单元 格 则 表示 传递 性 依赖 范围 。 


表 5-2 ”依赖 范围 影响 传递 性 依赖 


compile test provided runtime 

compile compile = = runtime 
test test = = test 

provided provided = provided provided 

runtime runtime ms =s runtime 


为 了 能 够 帮助 读者 更 好 地 理解 表 5-2， 这 里 再 举 个 例子 。account- 
email 项 目 有 一 个 com.icegreen: greenmail: 1.3.1b 的 直接 依赖 ， 我 们 说 
这 是 第 一 直接 依赖 ， 其 依赖 范围 是 test， 而 greenmail 义 有 一 个 
javax.mail: mail: 1.4 的 直接 依赖 ， 我 们 说 这 十 第 二 直接 依赖 ， 其 依赖 


范围 是 compile。 显 然 javax.mail: mail: 1.4 是 account-email 的 传递 性 依 
赖 ， 对 照 表 5-2 可 以 知道 ， 当 第 一 直接 依赖 范围 为 test， 第 二 直接 依赖 范 
是 compile 的 时 候 ， 传 递 性 依赖 的 苑 围 是 test， 因 此 javax.mail: mail: 

1.4 是 account-email 的 一 个 范围 是 test 的 传递 性 依赖 。 


仔细 观察 一 下 表 5-2， 可 以 发 现 这 样 的 规律 : 当 第 二 直接 依赖 的 苑 
围 是 compile 的 时 候 ， 传 递 性 依赖 的 范围 与 第 一 直接 依赖 的 范围 一 致 ; 
当 第 二 直接 依赖 的 范围 是 test 的 时 候 ， 依 赖 不 会 得 以 传递 ; 当 第 二 直接 
依赖 的 范围 是 provided 的 时 候 ， 只 传递 第 一 直接 依赖 范围 也 为 provided 
的 依赖 ， 且 传递 性 依赖 的 范围 同样 为 provided; 当 第 二 直接 依赖 的 苑 
征 runtime 的 时 候 ， 传 着 性 依赖 的 范围 与 第 一 直接 依赖 的 范围 一 致 ， 但 
compile 例 外 ， 此 时 传递 性 依赖 的 范围 为 runtime ° 


5.7 ”依赖 调解 


Maven 引 入 的 传递 性 依赖 机 制 ， 一 方面 大 大 简化 和 方便 了 依赖 声 
明 ， 另 一 方面 ， 大 部 分 情况 下 我 们 只 需要 关心 项 目的 直接 依赖 是 什 
么 ， 而 不 用 考虑 这 些 直接 依赖 会 引入 什么 传递 性 依赖 。 但 有 时 候 ， 当 
传递 性 依赖 造成 回 题 的 时 候 ， 我 们 整 需 要 清楚 地 知道 该 传递 性 依赖 古 
从 哪 条 依赖 路 径 引 入 的 。 


例如 ， 项 目 A 有 这 样 的 依赖 关系 : A->B->C->X (1.0) 、A->D->X 
(2.0) ，X 是 A 的 传递 性 依赖 ， 但 是 两 条 依赖 路 径 上 有 两 个 版 本 的 X， 
那么 哪个 X 会 被 Maven 解 析 使 用 呢 ? 两 个 版 本 都 被 解析 显然 是 不 对 的 ， 
因为 那 会 造成 依赖 重复 ， 因 此 必须 选择 一 个 。Maven 依 赖 调解 
(Dependency Mediation) 的 第 一 原则 是 : 路径 最 近 者 优先 。 该 例 中 X 
(1.0) 的 路 径 长 度 为 3， 而 X (2.0) 的 路 径 长 度 为 2， 因 此 X (2.0) 会 
被 解析 使 用 。 


依赖 调解 第 一 原则 不 能 解决 所 有 问题 ， 比 如 这 样 的 依赖 关系 : A- 
>B->Y (1.0) 、A->C->Y (2.0) , Y (1.0) 和 Y (2.0) 的 依赖 路 径 长 
度 是 一 样 的 ， 都 为 2。 那 么 到 底 谁 会 被 解析 使 用 呢 ? 在 Maven 2.0.8 及 之 
前 的 版 本 中 ， 这 是 不 确定 的 ， 但 是 从 Maven 2.0.9 开 始 ， 为 了 尽 可 能 避 
免 构建 的 不 确定 性 ，Maven 定 义 了 依赖 调解 的 第 二 原则 : 第 一 声明 者 
优先 。 在 依赖 路 径 长 度 相等 的 前 提 下 ， 在 POM 中 依赖 声明 的 顺序 决定 
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依赖 声明 在 C 之 前 ， 那 么 Y (1.0) 就 会 被 解析 使 用 。 


5.8 可 选 依赖 


假设 有 这 样 一 个 依赖 关系 ， 项 目 A 依 赖 于 项 目 B， 项 目 B 依 赖 于 项 
目 X 和 Y，B 对 于 X 和 Y 的 依赖 都 是 可 选 依赖 : A->B、B->X《〈 可 选 ) 、 
B->Y (可 选 ) 。 根 据 传递 性 依赖 的 定义 ， 如 果 所 有 这 三 个 依赖 的 范围 
都 是 compile， 那 么 X、Y 就 是 A 的 compile 范 围 传递 性 依赖 。 然 而 ， 由 于 
这 里 X、Y 是 可 选 依赖 ， 依 赖 将 不 会 得 以 传递 。 换 句 话说 ，X、Y 将 不 
会 对 A 有 任何 影响 ， 如 图 5-3 所 示 。 


~~ 
rid X( 可 选 依赖 ) 
A > B < 
o Na n Y( 可 选 依赖 ) 
| 


图 5-3 ”可 选 依赖 


为 什么 要 使 用 可 选 依赖 这 一 特性 呢 ? 可 能 项 目 B 实 现 了 两 个 特性 ， 
其 中 的 特性 一 依赖 于 X， 特 性 二 依赖 于 Y， 而 且 这 两 个 特性 是 互 斥 的 ， 
用 户 不 可 能 同时 使 用 两 个 特性 。 比 如 B 是 一 个 持久 层 隔离 工具 包 ， 它 文 
持 多 种 数据 库 ， 包 括 MySQL、PostgreSQL 等 ， 在 构建 这 个 工具 包 的 时 
候 ， 需 要 这 两 种 数据 库 的 驱动 程序 ， 但 在 使 用 这 个 工具 包 的 时 候 ， 只 
会 依赖 一 种 数据 库 。 


项 目 B 的 依赖 声明 见 代码 请 单 5-7。 
代码 清单 5-7 ”可 选 依赖 的 配置 


<project > 
<modelVersion >4.0.0 < /modelVersion > 
<grou p Id >com. juvenxu. mvnbook < /groupId > 
-artifactId> > proj ject-b < /artifactId > 
version: > 工 .0.0</version > 


ica a 


YSO F onnector-java < /artifactId> 


car 


0 < /version > 
<: optiona 2 >true < Took ional > 
< pein tc > 
< dependency > 
<groupId >postgresql < /groupId > 
<artifactId >postgresal < /artifactid> 
< version >8.4-701. jdbc3 < /version > 
<optional >true < /optional > 
< /dependency > 
< /dGependencies > 
</project > 


上 述 XML 代 码 片 段 中 ， 使 用 <optional> 元 素 表 示 mysql-connector- 
java 和 postgresql 这 两 个 依赖 为 可 选 依赖 ， 它 们 只 会 对 当前 项 目 B 产 生 影 
啊 ， 当 其 他 项 目 依赖 于 B 的 时 候 ， 这 两 个 依赖 不 会 被 传递 。 因 此 ， 当 项 
目 A 依 赖 于 项 目 B 的 时 候 ， 如 宁 其 实际 使 用 基于 MySQL 数 据 库 ， 那 么 在 
项 目 A 中 就 需要 显 式 地 声明 mysql-connector-java 这 一 依赖 ， 见 代码 清单 
5-8 ° 


代码 清单 5-8 可 选 依赖 不 被 传递 


artifactId >pre ct-b< /artifactId> 
<version >1.0.0</version > 


=p endent 


< /dependencies > 
‘project > 


最 后 ， 关 于 可 选 依赖 需要 说 明 的 一 点 是 ， 在 理想 的 情况 下 ， 是 不 
应 该 使 用 可 选 依赖 的 。 前 面 我 们 可 以 看 到 ， 使 用 可 选 依赖 的 原因 是 某 
一 个 项 目 实现 了 多 个 特性 ， 在 面向 对 象 设 计 中 ， 有 个 单一 职责 性 原 
则 ， 意 指 一 个 类 应 该 只 有 一 项 职责 ， 而 不 是 焰 合 太 多 的 功能 。 这 个 原 
则 在 规划 Maven 项 目的 时 候 也 同样 适用 。 在 上 面 的 例子 中 ， 更 好 的 做 法 
是 为 MySQL 和 PostgreSQL 分 别 创建 一 个 Maven 项 目 ， 基 于 同样 的 


groupId 分 配 不 同 的 artifactd， 如 com.juvenxu.mvnbook: project-b-mysql 


Allcom.juvenxu.mvnbook: project-b-postgresql， 在 各 自 的 POM 中 声明 对 
应 的 JDBC 了 驱动 依赖 ， 而 且 不 使 用 可 选 依 赖 ， 用 户 则 根据 需要 选择 使 用 
project-b-mysql 或 者 project-b-postgresql。 由 于 传递 性 依赖 的 作用 ， 就 不 
用 再 声明 JDBC 了 驱动 依赖 。 


5.9 WEKE 


Maven 依 赖 涉 及 的 知识 点 比较 多 ， 在 理解 了 主要 的 功能 和 原理 之 
后 ， 最 需要 的 当然 束 是 前 人 的 经 验 总 结 了， 我 们 称 之 为 最 佳 实践 。 本 
小 市 归纳 了 一 些 使 用 Maven 依 赖 和 常见 的 技巧 ， 方 便 用 来 避免 和 处 理 很 


多 第 见 的 问题 。 


5.9.1 “排除 依赖 


传递 性 依赖 会 给 项 目 隐 式 地 引入 很 多 依赖 ， 这 极 大 地 简化 了 项 目 
依赖 的 管理 ， 但 是 有 些 时 候 这 种 特性 也 会 带 来 问题 。 例 如 ， 当 前 项 目 
有 一 个 第 三 方 依赖 ， 而 这 个 第 三 方 依 赖 由 于 某 些 原因 依赖 了 另外 一 个 
类 库 的 SNAPSHOT 版 本 ， 那 么 这 个 SNAPSHOT 就 会 成 为 当前 项 目的 传 

递 性 依赖 ， 而 SNAPSHOT 的 不 稳定 性 会 直接 影响 到 当前 的 项 目 。 这 时 
就 需要 排除 挥 该 SNAPSHOT， 并 且 在 当前 项 目 中 声明 该 类 库 的 某 个 正 
式 发 布 的 版 本 。 还 有 一 些 情况 ， 你 可 能 也 想 要 替换 某 个 传递 性 依赖 ， 
比如 Sun JTA API，Hibernate 依 赖 于 这 个 JAR， 但 是 由 于 版 权 的 因素 ， 
该 类 库 不 在 中 央 仓 库 中 ， 而 Apache Geronimo 项 目 有 一 个 对 应 的 实现 。 
这 时 你 瓯 可 以 排除 Sun JAT API， 再 声明 Geronimo 的 JTA API 实 现 ， 见 代 
码 清单 5-9。 


代码 清单 5-9 ”排除 传递 性 依赖 


<groupId >com. juvenxu. mvnbook < /groupId > 
<artifactId>project-a < /artifactId > 
<version >1.0.0 < /version > 


< dependencies > 


<groupid >com. juvenxu. mvnbook < /groupId > 
<artifactId >project-c < /artifactid> 
< f/exclusion > 
< /exclusions > 
< /dependency > 
< dependency > 
<groupId>com. juvenxu.mvynbook < /grouplId > 
<artifactId >project-c < /artifactId> 
<version>1.1.0 <version> 
< /dependency > 
< /dependencies > 


</project > 


上 壕 代 码 中 ， 项 目 A 依 赖 于 项 目 B， 但 是 由 于 一 些 原因 ， 不 想 引 入 
传递 性 依赖 C， 而 是 目 己 显 式 地 声明 对 于 项 目 C 1.1.0 版 本 的 依赖 。 代 码 
中 使 用 exclusions 元 素 声 明 排除 依赖 ，exclusions 可 以 包含 一 个 或 者 多 个 
exclusion 子 元 素 ， 因 此 可 以 排除 一 个 或 者 多 个 传递 性 依赖 。 需 要 注意 的 
是 ， 声 明 exclusion 的 时 候 只 需要 groupId 和 artifactId， 而 不 需要 version 元 
素 ， 这 是 因为 只 需要 groupId 和 artifactId 束 能 唯一 定位 依赖 图 中 的 某 个 依 
赖 。 换 句 话说 ，Maven 解 析 后 的 依赖 中 ， 不 可 能 出 现 groupId 和 artifactId 
相同 ， 但 是 version 不 同 的 两 个 依赖 ， 这 一 点 在 5.6 节 中 已 做 过 解释 。 该 
例 的 依赖 解析 逻辑 如 图 5-4 所 示 。 


A m a eR C(version?) | 
i. OO 
C(version 1.10) 


图 5-4 ”排除 依赖 


5.9.2 JAR 


在 5.3.1 节 中 ， 有 很 多 关于 Spring Framework 的 依赖 ， 它 们 分 别 是 
org.springframework: spring-core: 2.5.6 ` org.springframework: spring- 
beans: 2.5.6 ` org.springframework: spring-context: 2.5.6 和 
org.springframework: spring-context-support: 2.5.6， 它 们 是 来 自 同 一 项 
目的 不 同 模 块 。 因 此 ， 所 有 这 些 依 赖 的 版 本 部 是 相同 的 ， 而 且 可 以 预 
见 ， 如 果 将 来 需要 升级 Spring Framework， 这 些 依赖 的 版 本 会 一 起 升 
级 。 这 一 情况 在 Java 中 似曾相识 ， 考 虑 如 下 简单 代码 〈 见 代码 清单 5- 
10) ° 


代码 清单 5-10 Java 中 重复 使 用 字面 量 


这 两 个 简单 的 方程 式 计 算 圆 的 周 长 和 面积 ， 稍 微 有 经 验 的 程序 员 
一 眼 就 会 看 出 一 个 问题 ， 使 用 字面 量 (3.14) 显然 不 合适 ， 应 该 使 用 定 
义 一 个 稼 量 并 在 方法 中 使 用 ， 见 代码 清单 5-11。 


代码 清单 5-11 Java 中 使 用 常量 


(EA Ae MULLS eis Bia, EERE DRE oe Be A 
在 需要 更 改 PI 的 值 的 时 候 ， 只 需要 修改 一 处 ， 降 低 了 错误 发 生 的 概 


同 理 ， 对 于 account-email 中 这 些 Spring Framework 来 说 ， 也 应 该 在 
一 个 唯一 的 地 方 定义 版 本 ， 并 且 在 dependency 声 明 中 引用 这 一 版 本 。 这 
样 ， 在 升级 Spring Framework 的 时 候 就 只 需要 修改 一 处 ， 实 现 方式 见 代 
码 清单 5-12 ° 


代码 清单 5-12 ”使 用 Maven 属 性 归 类 依赖 


<modelVersion >4.0.0 </modelVersion > 


< GroupIG > com. juven.mvnbo 
<artifactId >account-email < /artifactId > 
<name >Account Email < /name > 


< version >1.0.0-SNAPSHOT < /version > 


<properties > 
<springframework. version >2.5.6 < /springframework. version > 


< /properties > 


< dependencies > 


< dependency > 


< groupId >org. springframework < /groupId > 
<artifactId >spring-core < /artifactId> 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<grouplid >org. springframework < /groupid > 
<artifactId >spring-beans < /artifactId> 


<version > $ {springframework. version} < /version > 


< dependency > 


<groupId >org; springframework < /groupId > 


spring-context < /artifactId> 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupId >org. springframework < /groupId > 
<artifactid> 
<version> $ {springframework. version} < /version > 
< /dependency > 


< /dependencies > 


ng-context-support < /artifactid> 


< /project > 


这 里 简单 用 到 了 Maven 属 性 〈14.1 节 会 详细 介绍 Maven 属 性 ) ， 首 
先 使 用 properties 元 素 定 义 Maven 属 性 ， 该 例 中 定义 了 一 个 
springframework.version 子 元 素 ， 其 值 为 2.5.6。 有 了 这 个 属性 定义 之 
后 ，Maven 运 行 的 时 候 会 将 POM 中 的 所 有 的 中 
{springframework.version} 替 换 成 实际 值 2.5.6。 也 就 是 说 ， 可 以 使 用 美 
元 符号 和 大 括 弧 环绕 的 方式 引用 Maven 属 性 。 人 然后， 将 所 有 Spring 
Framework 依 赖 的 版 本 值 用 这 一 属性 引用 表示 。 这 和 在 Java 中 用 常量 PI 
替换 3.14 是 同样 的 道理 ， 不 同 的 只 是 语法 。 


5.9.3 ”优化 依赖 


在 软件 开发 过 程 中 ， 程 序 员 会 通过 重 构 等 方式 不 断 地 优化 目 己 的 
代码 ， 使 其 变 得 更 简洁 、 更 灵活 。 同 理 ， 程 序 员 也 应 该 能 够 对 Maven 项 
目的 依赖 了 然 于 胸 ， 并 对 其 进行 优化 ， 如 去 除 多 余 的 依赖 ， 显 式 地 声 
明 某 些 必 要 的 依赖 。 


通过 阅读 本 章 前 面 的 内 容 ， 读 者 应 该 能 够 了 解 到 : Maven 会 目 动 解 
析 所 有 项 目的 直接 依赖 和 传递 性 依赖 ， 并 且 根据 规则 正确 判断 每 个 依 
赖 的 范围 ， 对 于 一 些 依赖 冲突 ， 也 能 进行 调 太 ， 以 确保 任何 一 个 构件 
只 有 唯一 的 版 本 在 依赖 中 存在 。 在 这 些 工作 之 后 ， 最 后 得 到 的 那些 依 
赖 被 称 为 已 解析 依赖 (Resolved Dependency) 。 可 以 运行 如 下 的 命令 
查看 当前 项 目的 已 解析 依赖: 


mvn dependency :list 


在 account-email 项 目 中 执行 该 命令 ， 结 果 如 图 5-5 所 示 。 


Scanning for projects... 
Searching repository for plugin with prefix: ’dependency’. 


Building Account Email 
task-segment: [dependency: list] 


(dependency: list execution: default-cli>] 


The following files have been resolved: 
aopalliance:aopalliance: jar:1.@:compile 
com. icegreen:greenmail: jar:1.3.ib:test 
commons—logging-commons—logging: jar-:1.1.1-:compile 
javax.activation‘:activation: jar:1.1:compile 


javax.mail:mail: jar:1.4.1:compile 


junit: junit: jar:4.?:test 
org .slf4j:slf4j-api: jar:1.3.1:test 
“q.springf ramework-spring—beans: jar:2.5.6-compile 
*g.springf ramework:spring—context:jar:2.5.6:compile 
“¢ .springframework-:spring—context—support : jar:2.5.6:compile 
‘g.springf ramework:spring—core : jar:2.5.6:compile 


图 5-5 已 解析 依赖 列表 


图 5-5 显 示 了 所 有 account-email 的 已 解析 依赖 ， 同 时 ， 每 个 依赖 的 
范围 也 得 以 明确 标示 。 


在 此 基础 上 ， 还 能 进一步 了 解 已 解析 依赖 的 信息 。 将 直接 在 当前 
项 目 POM 声 明 的 依赖 定义 为 项 层 依 赖 ， 而 这 些 顶 层 依赖 的 依赖 则 定义 
为 第 二 层 依 赖 ， 以 此 类 推 ， 有 第 三 、 第 四 层 依赖 。 当 这 些 依赖 经 Maven 
解析 后 ， 束 会 构成 一 个 依赖 树 ， 通 过 这 标 依赖 树 束 能 很 清楚 地 看 到 某 
个 依赖 是 通过 哪 条 传递 路 径 引 入 的 。 可 以 运行 如 下 命令 查看 当前 项 目 
的 依赖 树 : 


在 acccountremail 中 执行 该 命令 ， 效 果 如 图 5-6 所 示 。 


Scanning for projec 
Searching nalni EAY for plugin with prefix: ’dependency’. 


Building Account Email 
task-segment: [dependency:tree ] 


Cdependency:tree execution: default—cli>] 
com. juven.munbook.account -account—email: jar:1.6.@-SNAPSHOT 
- org.springframework:spring-—core: jar:2.5.6:compile 
\- commons-—logging:commons—logging: jar:1.1.1:compile 
org.springf ramevork:spring—beans: jar:2.5.6:compile 
org.springf ramevork:spring-—context :jar:2.5.6-:compile 
\- aopalliance:aopalliance: jar-1.@:compile 
org.springf ramevork:spring—context—support : jar:2.5.6:compile 
javax.mail-:mail: jar:1.4.1:compile 
\ javax. oe 
junit: junit: i 
com.icegreen: ee Jar:1i.3.1hb:test 
\ org.slf4j:slf4j-api: jar:1.3.1:test 


BUILD SUCCESSFUL 


图 5-6 已 解析 依赖 树 


从 图 5-6 中 能 够 看 到 ， 虽 然 我 们 没有 声明 org.slf4j: slf4j-api: 1.3 这 
一 依赖 ， 但 它 还 是 经 过 com.icegreen: greenmail: 1.3 成 为 了 当前 项 目的 
传递 性 依赖 ， 而 且 其 范围 是 test。 


使 用 dependency: list 和 dependency: tree 可 以 帮助 我 们 详细 了 解 项 
目 中 所 有 依赖 的 具体 信息 ， 在 此 基础 上 ， 还 有 dependency: analyze 工 具 
可 以 帮助 分 析 当 前 项 目的 依赖 。 


为 了 说 明 该 工具 的 用 途 ， 先 将 5.3.1 节 中 的 spring-context 这 一 依赖 市 
除 ， 然 后 构建 项 目 ， 你 会 发 现 编译 、 测 试 和 打包 都 不 会 有 任何 问题 。 
通过 分 析 依 赖 树 ， 可 以 看 到 spring-context 是 spring-context-support 的 依 
赖 ， 因 此 会 得 以 传递 到 项 目的 classspath 中 。 现 在 再 运行 如 下 命令 


结果 如 图 5-7 所 示 。 


[INFO] Preparing dependency:analyze 

[INFO] [resources:resources execution: default—resources?] 

[VARNING] Using platform encoding (GB18@36 actually> to copy filtered 
[INFO] Copying 1 resource 

CINFO] [Ccompiler:compile <execution: default—compile>] 

[INFO] Nothing to compile — all classes are up to date 

[INFO] [resources:testResources execution: default-testResources> ] 
[VARNING] Using platform encoding (GB18636 actually) to copy filtered 
[INFO] Copying 1 resource 

[INFO] [Ceompiler:testCompile execution: default—testCompile?> ] 

LINFO] Nothing to compile 一 all classes are up to date 

[INFO] [dependency-:analyze execution: default-cli>] 

CWARNING] Used undeclared dependencies found: 

[VARNING] org.springf ramework:spring—context :jar:2.5.6:compile 
CWARNING] Unused declared dependencies found: 

[VARNING] org .springf ramework:spring—core: jar:2.5.6:compile 
[VARNING] org.springf ramework:spring—beans: jar:2.5.6:compile 


图 5-7 使 用 但 未 声明 的 依赖 与 声明 但 未 使 用 的 依赖 


该 结果 中 重要 的 是 两 个 部 分 。 首 先是 Used undeclared 
dependencies， 意 指 项 目 中 使 用 到 的 ， 但 是 没有 显 式 声明 的 依赖 ， 这 里 
7eSpring-context ° 这 种 依赖 意味 着 潜在 的 风险 ， 当 前 项 目 直 接 在 使 用 它 
们 ， 例 如 有 很 多 相关 的 Java import 声 明 ， 而 这 种 依赖 是 通过 直接 依赖 传 


累进 来 的 ， 当 升级 直接 依赖 的 时 候 ， 相 关 传 递 性 依赖 的 版 本 也 可 能 发 
生变 化 ， 这 种 变化 不 易 察 觉 ， 但 是 有 可 能 导致 当 前 项 目 出 错 。 例 如 由 
于 接口 的 改变 ， 当 前 项 目 中 的 相关 代码 无 法 编译 。 这 种 隐藏 的 、 洪 在 
的 威胁 一 旦 出 现 ， 束 往往 需要 耗费 大 量 的 时 间 来 查 明 真相 。 因 此 ， 显 
式 声 明 任何 项 目 中 直接 用 到 的 依赖 。 


结果 中 还 有 一 个 重要 的 部 分 是 Unused declared dependencies， 意 指 
项 目 中 未 使 用 的 ， 但 显 式 声 明 的 依赖 ， 这 里 有 spring-core 和 spring- 
beans。 需 要 注意 的 是 ， 对 于 这 样 一 类 依赖 ， 我 们 不 应 该 简单 地 直接 删 
除 其 声明 ， 而 是 应 该 仔细 分 析 。 由 于 dependency: analyze 只 会 分 析 编译 
主 代 码 和 测试 代码 需要 用 到 的 依赖 ， 一 些 执行 测试 和 运行 时 需要 的 依 
赖 它 就 发 现 不 了 。 很 显然 ， 该 例 中 的 spring-core 和 spring-beans 是 运行 
Spring Framework 项 目 必 要 的 类 库 ， 因 此 不 应 该 删除 依赖 声明 。 当 然 ， 
有 了 时候 确 实 能 通过 该 信息 找到 一 些 没 用 的 依赖 ， 但 一 定 要 小 心 测试 。 


5.10 45 


本 章 主 要 介绍 了 Maven 的 两 个 核心 概念 : 坐标 和 依赖 。 解 释 了 坐 
标的 由 来 ， 并 详细 阐述 了 各 坐标 元 素 的 作用 及 定义 方式 。 随 后 引入 
account-email 这 一 实际 的 基于 Spring Framework 的 模块 ， 包 括 了 POM 定 
义 、 主 代码 和 测试 代码 。 在 这 一 直观 感受 的 基础 上 ， 再 花 了 大 篇 幅 介 
绍 Maven 依 赖 ， 包 括 依赖 范围 、 传 递 性 依赖 、 可 选 依赖 等 概念 。 最 
后 ， 当 然 少不了 关于 依赖 的 一 些 最 佳 实践 。 通 过 阅读 本 章 ， 读 者 应 该 
已 经 能 够 透彻 地 了 解 Maven 的 依赖 管理 机 制 。 下 一 章 将 会 介绍 Maven 
的 另 一 个 核心 概念 : 仓库 。 


. 何 为 Maven 仓 库 


-仓库 的 布局 


远程 仓库 的 配置 


快照 版 本 


从 仓库 解析 依赖 的 机 制 


-镜像 


“仓库 搜索 服务 


-小结 


第 5 章 详细 介绍 了 Maven 坐 标 和 依赖 ， 坐 标 和 依赖 是 任何 一 个 构件 
在 Maven 世 界 中 的 逻辑 表示 方式 ， 而 构件 的 物理 表示 方式 是 文件 ， 
Maven 通 过 仓库 来 统一 管理 这 些 文 件 。 本 章 将 详细 介绍 Maven 仓 库 ， 


在 了 解 了 Maven 如 何 使 用 仓库 之 后 ， 将 能 够 更 高 效 地 使 用 Maven 。 


6.1 Maven CJE 


在 Maven 世 界 中 ， 任 何 一 个 依赖 、 揪 件 或 者 项 目 构建 的 输出 ， 都 
可 以 称 为 构件 。 例 如 ， 依 赖 log4j-1.2.15.jar 是 一 个 构件 ， 插 件 maven- 
compiler-plugin-2.0.2.jar 是 一 个 构件 ， 第 5 章 的 account-email 项 目 构建 完 
成 后 的 输出 account-email-1.0.0-SNAPSHOT.jar 也 是 一 个 构件 。 任 何 一 
个 构件 都 有 一 组 坐标 唯一 标识 。 


在 一 台 工 作 站 上 ， 可 能 会 有 几 十 个 Maven 项 目 ， 所 有 项 目 都 使 用 
maven-compiler-plugin， 这 些 项 目 中 的 大 部 分 都 用 到 了 log4j， 有 一 小 部 
分 用 到 了 Spring Framework， 还 有 另外 一 小 部 分 用 到 了 Struts2。 在 每 个 
有 需要 的 项 目 中 都 放置 一 份 重复 的 log4j 或 者 struts2 显 然 不 是 最 好 的 解 
决 方案 ， 这 样 做 不 仅 造 成 了 人 磁盘 空间 的 淄 费 ， 而 且 也 难于 统一 管理 ， 
文件 的 复制 等 操作 也 会 降低 构建 的 速度 。 而 实际 情况 是 ， 在 不 使 用 
Maven 的 那些 项 目 中 ， 我 们 往往 束 能 发 现 命 名 为 lib/ 的 目 隶 ， 各 个 项 目 
lib/ 目 隶 下 的 内 容 存 在 大 量 的 重复 。 


得 益 于 坐标 机 制 ， 任 何 Maven 项 目 使 用 任何 一 个 构件 的 方式 都 是 
完全 相同 的 。 在 此 基础 上 ，Maven 可 以 在 某 个 位 置 统一 存储 所 有 
Maven 项 目 共享 的 构件 ， 这 个 统一 的 位 置 就 是 仓库 。 实 际 的 Maven 项 


目 将 不 再 各 目 存储 其 依赖 文件 ， 它 们 只 需要 声明 这 些 依赖 的 坐标 ， 在 


需要 的 时 候 (例如 ， 编 译 项 目的 时 候 需 要 将 依赖 加 入 到 classpath 
中 ) ，Maven 会 自动 根据 坐标 找到 仓库 中 的 构件 ， 并 使 用 它们 。 


为 了 实现 重用 ， 项 目 构建 完毕 后 生成 的 构件 也 可 以 安 朔 或 者 部 署 
到 仓库 中 ， 供 其 他 项 目 使 用 。 


6.2 仓库 的 布局 


任何 一 个 构件 都 有 其 唯一 的 坐标 ， 根 据 这 个 坐标 可 以 定义 其 在 仓 
库 中 的 唯一 存储 路 径 ， 这 便 是 Maven 的 仓库 布局 方式 。 例 如 ，log44j: 
log4j: 1.2.15 这 一 依赖 ， 其 对 应 的 仓库 路 人 径 为 log4j/log4j/1.2.15/log4j- 
1.2.15.jar， 细 心 的 读者 可 以 观察 到 ， 该 路 径 与 坐标 的 大 致 对 应 关系 为 
groupId/artifactId/version/artifactId-version.packaging。 下 面 看 一 段 Maven 
的 源码 ， 并 结合 具体 的 实例 来 理解 Maven 仓 库 的 布局 方式 ， 见 代码 清单 
6-1: 


代码 清单 6-1 Maven 处 理 仓库 布局 的 源码 


private static final char PATH_SEPARATOR ='/'; 
private static final char GROUP_SEPARATOR ='.'; 


rivate static final char ARTIFACT_SEPARATOR ='-'; 


public String pathOf( Artifact artifact ) 

ArtifactHandler artifactHandler =artifact.getArtifactHandler (); 

StringBuilder path =new StringBuilder (128 ); 

path. append( formatAsDirectory (artifact. getGroupId{) ) ). append( PATH_SEPA- 
RATOR ) ; 

path. append( artifact.getArtifactId({) ).append( PATH_SEPARATOR ) ; 

path. append( artifact.getBaseVersion() ).append( PATH_SEPARATOR ); 

path. append( artifact.getArtifactId() ). append( ARTIFACT_SEPARATOR ). append 
(artifact. getVersion() ); 


if (artifact. hasClassifier() ) 


path. append ( ARTIFACT_SEPARATOR }).append( artifact.getClassifier() ); 
全 
1 


if ( artifactHandler.getExtension () != null && artifactHandler.getExtension () 
.length(} > 0) 


path. append ( GROUP_SEPARATOR }. append ( artifactHandler.getExtension() ); 
} 


return path. toString (); 


private String formatAsDirectory ( String directory ) 


return directory. replace ( GROUP_SEPARATOR, PATH_SEPARATOR ); 


该 pathOf () 方法 的 目的 是 根据 构件 信息 生成 其 在 仓库 中 的 路 径 。 
在 阅读 本 段 代码 之 前 ， 可 以 先 回顾 一 下 第 5 章 的 相关 内 容 。 这 里 根据 一 
个 实际 的 例子 来 分 析 路 径 的 生成 ， 考 虑 这 样 一 个 构件 : 
groupId=org.testng ` artifactId=testng ` version=5.8 ` classifier=jdk15 ` 
packaging=jar， 其 对 应 的 路 径 按 如 下 步骤 生成 : 


1) 基于 构件 的 groupId 准 备 路 人 径 ，formatAsDirectory () 将 groupId 
中 的 句点 分 隅 符 转 换 成 路 径 分 隔 符 。 该 例 中 ，groupId org.testng 就 会 被 


转换 成 org/testmg， 之 后 再 加 一 个 路 径 分 隔 符 斜 枉 ， 那 么 ，org.testng 怠 
成 为 了 org/testng/。 


2) 基于 构件 的 artifactId 准 备 路 径 ， 也 就 是 在 前 面 的 基础 上 加 上 
artifactId 以 及 一 个 路 径 分 隔 符 。 该 例 中 的 artifactId 为 testnmg， 那 么 ， 在 这 
一 步 过 后 ， 路 径 就 成 为 了 org/testng/testng/。 


3) 使 用 版 本 信息 。 在 前 面 的 基础 上 加 上 version 和 路 径 分 隔 符 。 该 
例 中 版 本 是 5.8， 那 么 路 径 吏 成 为 了 orgy/testng/tesgng/5.8/。 


4) 依次 加 上 artifactd， 构 件 分 隔 符 连 字号 ， 以 及 version， 于 是 构 
建 的 路 径 束 变 成 了 org/testng/testng/5.8/testng-5.8。 读 者 可 能 会 注意 到 ， 
这 里 使 用 了 artifactId.getVersion () ， 而 上 一 步 用 的 是 
artifactId.getBaseVersion () ，baseVersion 主 要 是 为 SNAPSHOT 版 本 服 
务 的 ， 例 如 version 为 1.0-SNAPSHOT 的 构件 ， 其 baseVersion 束 是 1.0。 


5) 如 果 构 件 有 classifier， 就 加 上 构件 分 隔 符 和 classifier。 该 例 中 构 
件 的 classifier 是 jdk15， 那 么 路 径 惑 变 成 org/testng/testng/5.8/testng-5.8- 
jdk5 ° 


6) 检查 构件 的 extension， 若 extension 存 在 ， 则 加 上 句点 分 隔 符 和 
extension。 从 代码 中 可 以 看 到 ，extension 是 从 artifactHandler 而 非 artifact 
获取 ，artifactHandler 是 由 项 目的 packaging 决 定 的 。 因 此 ， 可 以 说 ， 


packaging 决 定 了 构件 的 扩展 名 ， 该 例 的 packaging 是 jar， 因 此 最 终 的 路 
径 为 org/testng/testng/5.8/testng-5.8-jdk5.jar ° 


到 这 里 ， 应 该 感谢 Maven 开 源 社 区 ， 正 是 由 于 Maven 的 所 有 源 代码 
都 是 开放 的 ， 我 们 才能 仔细 地 深入 到 其 内 部 工作 的 所 有 细节 。 


Maven 仓 库 是 基于 简单 文件 系统 存储 的 ， 我 们 也 理解 了 其 存储 方 
式 ， 因 此 ， 当 过 到 一 些 与 仓库 相关 的 问题 时 ， 可 以 很 方便 地 查找 相关 
文件 ， 方 便 定 位 问题 。 例 如 ， 当 Maven 无 法 获得 项 目 声明 的 依赖 时 ， 可 
以 查看 该 依赖 对 应 的 文件 在 仓库 中 是 否 存 在 ， 如 采 不 存在 ， 查 看 忌 否 
有 其 他 版 本 可 用 ， 等 等 。 


6.3 仓库 的 分 类 


对 于 Maven 来 说 ， 仓 库 只 分 为 两 类 : 本 地 仓库 和 远程 仓库 。 当 
Maven 根 据 坐标 寻找 构件 的 时 候 ， 它 首先 会 查看 本 地 仓库 ， 如 有 果 本 地 
仓库 存在 此 构件 ， 则 直接 使 用 ， 如 有 果 本 地 仓库 不 存在 此 构件 ， 或 者 需 
要 查看 是 否 有 更 新 的 构件 版 本 ，Maven 束 会 去 远程 仓库 查找 ， 发 现 需 
要 的 构件 之 后 ， 下 载 到 本 地 仓库 再 使 用 。 如 有 果 本 地 仓库 和 远程 仓库 都 
没有 需要 的 构件 ，Maven 就 会 报错 。 


在 这 个 最 基本 分 类 的 基础 上 ， 还 有 必要 介绍 一 些 特殊 的 远程 仓 
库 。 中 央 仓 库 是 Maven 核 心目 这 的 远程 仓库 ， 它 包含 了 绝 大 部 分 开源 
的 构件 。 在 默认 配置 下 ， 当 本 地 仓库 没有 Maven 需 要 的 构件 的 时 候 ， 
ERS EN REE PR ° 


Ps Ae Fa — PPR RE OD, aa BEA Ta], MAEA 
域 网 内 架设 一 个 私有 的 仓库 服务 器， 用 其 代理 所 有 外 部 的 远程 仓库 。 
内 部 的 项 目 还 能 部 署 到 私服 上 供 其 他 项 目 使 用 。 


除了 中 央 仓 库 和 私服 ， 还 有 很 多 其 他 公开 的 远程 仓库 ， 常 见 的 有 
Java.net Maven 库 (http://download.java.net/maven/2/) 和 JBoss Maven 库 


(http://repository.jboss.com/maven2/) 等 。 


Maven 仓 库 的 分 类 见 图 6-1。 


Al6-1 Maven 仓 库 的 分 类 


6.3.1 本 地 仓库 


一 般 来 说 ， 在 Maven 项 目 目 孙 下 ， 没 有 诸如 lib/ 这 样 用 来 存放 依赖 
文件 的 目录 。 当 Maven 在 执行 编译 或 测试 时 ， 如 果 需 要 使 用 依赖 文件 ， 
它 总 是 基于 坐标 使 用 本 地 仓库 的 依赖 文件 。 


默认 情况 下 ， 不 管 是 在 Windows 还 是 Linux 上 ， 每 个 用 户 在 目 己 的 
用 户 目 好 下 都 有 一 个 路 人 径 名 为 .m2/repository/ 的 仓库 目录 。 例 如 ， 笔 者 
的 用 户 名 是 juven， 我 在 Windows 机 器 上 的 本 地 仓库 地 址 为 C: 
\Users\juven\.m2\repository\， 而 我 在 Linux 上 的 本 地 仓库 地 址 
为 /home/juven/.m2/repository/。 注意 ， 在 Linux 系 统 中 ， 以 点 (.) 开头 
的 文件 或 目录 默认 是 隐藏 的 ， 可 以 使 用 ls-a 命 令 显示 隐藏 文件 或 目录 。 


有 时 候 ， 因 为 某 些 原因 (例如 C 盘 空间 不 够 ) ， 用 户 会 想 要 自 定义 
本 地 仓库 目录 地 址 。 这 时 ， 可 以 编辑 文件 ~/.m2/settings.xml， 设 置 
localRepository 元 素 的 值 为 想 要 的 仓库 地 址 。 例 如 : 


<localRepository >D:\java \repository \< /localRepository > 


< /settings > 


这 样 ， 该 用 户 的 本 地 仓库 地 址 残 被 设置 成 了 D: \java\repository\ ° 


需要 注意 的 是 ， 默 认 情 况 下 ，~/.m2/settings.xml 文 件 是 不 存在 的 ， 
用 户 需 要 从 Maven 安 装 日 录 复 制 $M2_HOME/conf/settings.xml 文 件 再 进 
行 编辑 。 本 书 始终 推荐 大 家 不 要 直接 修改 全 局 日 如 的 settings.xml 文 件 ， 
具体 原因 已 在 第 2.7.2 广 中 曾 述 。 


一 个 构件 只 有 在 本 地 仓库 中 之 后 ， 才 能 由 其 他 Maven 项 目 使 用 ， 那 
么 构件 如 何 进入 到 本 地 仓库 中 呢 ? secs OLA Maven Mite BE F 
载 到 本 地 仓库 中 。 还 有 一 种 常见 的 情况 是 ， 将 本 地 项 目的 构件 安装 到 
Maven 仓 库 中 。 例 如 ， 本 地 有 两 个 项 目 A 和 B， 两 首都 无 法 从 远程 仓库 
获得 ， 而 同时 A 又 依 赖 于 B， 为 了 能 构建 A，B 就 必须 首先 得 以 构建 并 安 

装 到 本 地 仓库 中 。 


在 某 个 项 目 中 执行 mvn clean install 命 令 ， 就 能 看 到 如 下 输出 : 


INFO] [jar:jar {execution: default-jar}] 


INFO] Building jar: D:\git-—juven \maven-book \ code \ch-5 \account-email \target 
\account-email-1.0.0-SNAPSHOT. jar 

[INFO] [install:install {execution: default-install}] 

INFO] Inst all ing D:\git ven \maven-—-book \code \ch-5 \account-email \target \ac- 
count-ema 1-1 0.Q0-SNAPSHOT. jar to D: saw \repository \com\juven \mvnbook \account \ 
account—email \1.0.0 -SNAPSHOT \account-email-1.0.0-SNAPSHOT. ae 
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install 插 件 的 install 目 标 将 项 目的 构建 输出 文件 安装 到 本 地 仓库 。 


在 上 述 输出 中 ， 构 建 输出 文件 是 account-email-1.0.0-SNAPSHOT.jar， 本 
地 仓库 地 址 是 D: \java\repository，Maven 使 用 Install 插 件 将 该 文件 复制 


到 本 地 仓库 中 ， 具 体 的 路 径 根据 坐标 计算 获得 。 计 算 逻 辑 请 参考 6.2 


6.3.2 ”远程 仓库 


安装 好 Maven 后 ， 如 果 不 执行 任何 Maven 命 令 ， 本 地 仓库 日 录 是 
不 存在 的 。 当 用 户 输入 第 一 条 Maven 命 令 之 后 ，Maven 才 会 创建 本 地 
仓库 ， 然 后 根据 配置 和 需要 ， 从 远程 仓库 下 载 构件 至 本 地 仓库 。 


这 好 比 藏书 。 例 如 ， 我 想 要 读 《 红 楼 梦 》， 会 先 检查 目 己 的 书房 
古 否 已 经 收藏 了 这 本 书 ， 如 果 发 现 没 有 这 本 书 ， 于 是 丈 跑 去 书店 买 一 
本 回来 ， 放 到 书房 里 。 可 能 有 一 天 我 又 想 读 一 本 英文 版 的 《程序 员 修 
炼 之 道 》， 而 书房 里 只 有 中 文 版 ， 于 是 义 去 书店 找 ， 可 发 现 书店 没 
有 ， 好 在 还 有 网 上 书店 ， 于 是 从 Amazon 夹 了 一 本 ， 几 天 后 我 收 到 了 这 
本 书 ， 又 放 到 了 目 己 的 书房 。 


本 地 仓库 束 好 比 书房 ， 我 需要 读书 的 时 候 和 完 从 书房 找 ， 相 应 地 ， 
Maven 需 要 构件 的 时 候 先 从 本 地 仓库 找 。 远 程 仓库 就 好 比 书 店 (包括 
实体 书店 、 网 上 书店 等 ) ， 当 我 无 法 从 自己 的 书房 找到 需要 的 书 的 时 
候 ， 束 会 从 书店 购买 后 放 到 书房 里 。 当 Maven 无 法 从 本 地 仓库 找到 需 
要 的 构件 的 时 候 ， 就 会 从 远程 仓库 下 载 构 件 至 本 地 仓库 。 一 般 地 ， 对 
于 每 个 人 来 说 ， 书 房 只 有 一 个 ， 但 外 面 的 书店 有 很 多 ， 类 似 地 ， 对 于 
Maven 来 说 ， 每 个 用 户 只 有 一 个 本 地 仓库 ， 但 可 以 配置 访问 很 多 远程 
BE ° 


6.3.3 PRA 


由 于 最 原始 的 本 地 仓库 是 空 的 ，Maven 必 须知 道 至 少 一 个 可 用 的 
远程 仓库 ， 才 能 在 执行 Maven 命 令 的 时 候 下 载 到 需要 的 构件 。 中 央 仓 
库 就 是 这 样 一 个 默认 的 远程 仓库 ，Maven 的 安装 文件 自 带 了 中 央 仓 库 
的 配置 。 读 者 可 以 使 用 解压 工具 打开 jar 文 件 $ M2_HOME/ib/maven- 
model-builder-3.0.jar (在 Maven 2 中 ，jar 文 件 路 径 类 似 于 
$ M2_HOME/lib/maven-2.2.1-uber.jar) ， 然 后 访问 路 径 


org/apache/maven/model/pom-4.0.0.xml， 可 以 看 到 如 下 的 配置 : 


<name >Maven Repository Switchboard < /name > 
<url>http://repol.maven.org/maven2 < /url > 
< layout >default < /layout > 
< snapshots > 

< enabled > false < /enabled > 

/snapshots > 
/ repository > 


< / repositories > 


包含 这 段 配置 的 文件 是 所 有 Maven 项 目 都 会 继承 的 超级 POM， 第 8 
章 会 详细 介绍 继承 及 超级 POM 。 这 上段 配置 使 用 id central 对 中 央 仓 库 进 
行 唯 一 标识 ， 其 名 称 为 Maven Repository Switchboard， 它 使 用 default 仓 
库 布 局 ， 也 就 是 在 第 6.2 市 介绍 的 仓库 布局 。 对 于 Maven 1 的 仓库 ， 需 
要 配置 值 为 legacy 的 layout， 本 书 不 会 涉及 Maven 1° 最 后 需要 注音 的 


是 snapshots 元 素 ， 其 子 元素 enabled 的 值 为 false， 表 示 不 从 该 中 央 仓 库 
下 载 快照 版 本 的 构件 (本 章 稍 后 详细 介绍 快照 版 本 ) 。 


中 央 仓 库 包 含 了 这 个 世界 上 绝 大 多 数 流行 的 开源 Java 构 件 ， 以 及 
源码 、 作 者 信息 、SCM、 信 息 、 许 可 证 信息 等 ， 每 个 月 这 里 都 会 接受 
全 世界 Java 程 序 员 大 概 1 亿 次 的 访问 ， 它 对 全 世界 Java 开 发 者 的 页 献 由 
此 可 见 一 辛 。 由 于 中 央 仓 库 包 含 了 超过 2000 个 开源 项 目的 构件 ， 
此 ， 一 般 来 说 ， 一 个 简单 Maven 项 目 所 需要 的 依赖 构件 都 能 从 中 央 仓 
库 下 载 到 。 这 也 解释 了 为 什么 Maven 能 做 到 * 开 箱 即 用 ”。 


6.3.4 ALAR 


私服 是 一 种 特殊 的 远程 仓库 ， 它 是 架设 在 局 域 网 内 的 仓库 服务 ， 
私服 代理 广域网 上 的 远程 仓 亩 ， 供 局 域 网 内 的 Maven 用 户 使 用 。 当 
Maven 需 要 下 载 构件 的 时 候 ， 它 从 私服 请 求 ， 如 采 私 服 上 不 存在 该 构 
件 ， 则 从 外 部 的 远程 仓库 下 载 ， 缓 存在 私服 上 之 后 ， 再 为 Maven 的 下 
载 请 求 提供 服务 。 此 外 ， 一 些 无 法 从 外 部 仓库 下 载 到 的 构件 也 能 从 本 
地 上 传 到 私服 上 供 大 家 使 用 ， 如 图 6-2 所 示 。 


Maven 用 户 


缓存 构件 JBoss 仓库 


Maven 用 户 
Java.net 仓库 


图 6-2 私服 的 用 途 


图 6-2 展 示 的 是 组 织 内 部 使 用 私服 的 情况 。 即 使 在 一 台 直 接连 入 
Internet 的 个 人 机 器 上 使 用 Maven， 也 应 该 在 本 地 建立 私服 。 因 为 私服 
可 以 帮助 你 : 

:节省 目 己 的 外 网 这 宽 。 建 立 私 服 同 样 可 以 减少 组 织 目 己 的 开 文 ， 
大 量 的 对 于 外 部 仓库 的 重复 请 求 会 消耗 很 大 的 这 宽 ， 利 用 私服 代理 外 


Ok 


?仓库 之 后 ， 对 外 的 重复 构件 下 载 便 得 以 消除 ， 即 降低 外 网 帝 宽 的 压 


ot 


.加速 Maven 构 建 。 不 停 地 连接 请 求 外 部 仓库 是 十 分 耗 时 的 ， 但 是 
Maven 的 一 些 内 部 机 制 《如 快照 更 新 检查 ) 和 要求 Maven 在 执行 构建 的 时 
候 不 停 地 检查 远程 仓库 数据 。 因 此 ， 当 项 目 配置 了 很 多 外 部 远程 仓库 
的 时 候 ， 构 建 的 速度 会 被 大 大 降低 。 使 用 私服 可 以 很 好 地 解决 这 一 问 
题 ， 当 Maven 只 需要 检查 局 域 网 内 私服 的 数据 时 ， 构 建 的 速度 便 能 得 
到 很 大 程度 的 提高 。 


部署 第 三 方 构件 。 当 某 个 构件 无 法 从 任何 一 个 外 部 远程 仓库 获 
te, (ZIP? 这 样 的 例子 有 很 多 ， 如 组 织 内 部 生成 的 私有 构件 肯定 无 
法 从 外 部 仓库 获得 、Oracle 的 JDBC 驱 动 由 于 版 权 因 素 不 能 发 布 到 公共 
仓库 中 。 建 立 私服 之 后 ， 便 可 以 将 这 些 构件 部 署 到 这 个 内 部 的 仓库 
中 ， 供 内 部 的 Maven 项 目 使 用 。 


-提高 稳定 性 ， 增 强 控 制 。Maven 构 建 高 度 依赖 于 远程 仓库 ， 因 
此 ， 当 Internet 不 稳定 的 时 候 ，Maven 构 建 也 会 变 得 不 稳定 ， 甚 至 无 法 
构建 。 使 用 私服 后 ， 即 使 暂时 没有 Internet 连 接 ， 由 于 私服 中 已 经 缓存 
了 大 量 构件 ，Maven 也 仍然 可 以 正常 运行 。 此 外 ， 一 些 私 服 软 件 〈 如 
Nexus) 还 提供 了 很 多 额外 的 功能 ， 如 权限 管理 、 
RELEASE/SNAPSHOT 区 分 等 ， 管 理 员 可 以 对 仓库 进行 一 些 更 高 级 的 
控制 。 


:降低 中 央 仓 库 的 负荷 。 运 行 并 维护 一 个 中 央 仓 库 不 是 一 件 容易 的 
事情 ， 服 务 数 百 万 的 请 求 ， 存 储 数 Tf 的 数据 ， 需 要 相当 大 的 财力 。 使 用 
私服 可 以 避免 很 多 对 中 央 仓 库 重 复 的 下 载 ， 想 象 一 下 ， 一 个 有 数 百 位 
开发 人 员 的 公司 ， 在 不 使 用 私服 的 情况 下 ， 一 个 构件 往往 会 被 重复 下 
载 数 百 次 ， 建 并 私服 之 后 ， 这 几 百 次 下 载 束 只 会 发 生 在 内 网 范围 内 ， 


私服 对 于 中 央 仓 库 只 有 一 次 下 载 。 
建立 私服 是 用 好 Maven 十 分 关键 的 一 步 ， 第 9 章 会 专门 介绍 如 何 使 
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用 最 流行 的 Maven 私 服 软件 


6.4 ”远程 仓库 的 配置 


在 很 多 情况 下 ， 默 认 的 中 央 仓 库 无 法 满足 项 目的 需求 ， 可 能 项 目 
需要 的 构件 存在 于 另外 一 个 远程 仓库 中 ， 如 JBoss Maven 人 仓库。 这 时 ， 
可 以 在 POM 中 配置 该 仓库 ， 见 代码 清单 6-2。 

代码 清单 6-2 ”配置 POM 使 用 JBoss Maven 仓 库 


//repository. jboss. com/maven2 / < /url > 


< enabled >true < /enabled > 


< layout >default < /layout > 
< /repository > 


< /repositories > 


在 repositories 元 素 下 ， 可 以 使 用 repository 子 元 素 声 明 一 个 或 者 多 个 
远程 仓库 。 该 例 中 声明 了 一 个 id 为 jboss， 名 称 为 JBoss Repository 的 仓 
库 。 任 何 一 个 仓库 声明 的 id 必须 是 唯一 的 ， 尤 其 需要 注意 的 是 ，Maven 
自 带 的 中 央 仓 库 使 用 的 id 为 central， 如 果 其 他 的 仓库 声明 也 使 用 该 id， 
就 会 覆盖 中 央 仓 库 的 配置 。 该 配置 中 的 由 值 指向 了 仓库 的 地 址 ， 一 般 


来 说 ， 该 地 址 都 基于 http 协 议 ，Maven 用 户 都 可 以 在 浏览 器 中 打开 仓库 
地 址 浏 宽 构件 。 


该 例 配 置 中 的 releases 和 snapshots 元 素 比 较 重 要 ， 它 们 用 来 控制 
Maven 对 于 发 布 版 构件 和 快照 版 构件 的 下 载 。 天 于 快照 版 本 ， 在 第 6.5 
节 中 会 详细 解释 。 这 里 需要 注意 的 是 enabled 子 元 素 ， 该 例 中 releases 的 
enabled 值 为 true， 表 示 开 局 JBoss 仓库 的 发 布 版 本 下 载 文 持 ， 而 
snapshots 的 enabled 值 为 false， 表 示 天 闭 JBoss 仓 库 的 快照 版 本 的 下 载 文 
持 。 因 此 ， 根 据 该 配置 ，Maven 只 会 从 JBoss 仓库 下 载 发 布 版 的 构件 ， 
而 不 会 下 载 快 照 版 的 构件 。 


该 例 中 的 layout 元 系 值 default 表 示 仓 库 的 布局 是 Maven 2 及 Maven 3 
的 默认 布局 ， 而 不 是 Maven 1 的 布局 。 


对 于 releases 和 snapshots 来 说 ， 除 了 enabled， 它 们 还 包含 另外 两 个 


F Jt AupdatePolicy#checksumPolicy: 


元 素 updatePolicy 用 来 配置 Maven 从 远程 仓库 检查 更 新 的 频率 ， 默 
认 的 值 是 daily， 表 示 Maven 每 天 检查 一 次 。 其 他 可 用 的 值 包括 : never 


一 从 不 检查 更 新 ; always 一 每 次 构建 都 检查 更 新 ，interval: X 一 每 隔 X 
分 钟 检查 一 次 更 新 〈X 为 任意 整数 ) 。 


元 素 checksumPolicy 用 来 配置 Maven 检 查 检验 和 文件 的 策略 。 当 构 
件 被 部 署 到 Maven 仓 库 中 时 ， 会 同时 部 署 对 应 的 校 验 和 了 文件。 在 下 载 构 
件 的 时 候 ，Maven 会 验证 校 验 和 文件 ， 如 来 校 验 和 验证 失败 ， 怎 么 办 ? 
当 checksumPolicy 的 值 为 默认 的 warn 时 ，Maven 会 在 执行 构建 时 输出 警 
告 信息 ， 其 他 可 用 的 值 包括 : fail-Maven 遇 到 校 验 和 错误 就 让 构建 失 


AD; 


WM; ignore—fiMavenst E A REMER © 


6.4.1 ”远程 仓库 的 认证 


大 部 分 远程 仓库 无 须 认证 就 可 以 访问 ， 但 有 时 候 出 于 安全 方面 的 
考虑 ， 我 们 需要 提供 认证 信息 才能 访问 一 些 远程 仓 库 。 例 如 ， 组 织 
部 有 一 个 Maven 仓 库 服 务 器 ， 该 服务 器 为 每 个 项 目 都 提供 独立 的 Maven 
仓库 ， 为 了 防止 非法 的 仓库 访问 ， 管 理 员 为 每 个 仓库 提供 了 一 组 用 户 
名 及 密码 。 这 时 ， 为 了 能 让 Maven 访 问 仓 库 内 容 ， 就 需要 配置 认证 信 
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配置 认证 信息 和 配置 仓库 信息 不 同 ， 仓 库 信息 可 以 直接 配置 在 
POM 文 件 中 ， 但 是 认证 信息 必须 配置 在 settings.xml 文 件 中 。 这 和 是 因 为 
POM 人 往往 是 被 提交 到 代码 仓库 中 供 所 有 成 员 访 问 的， 而 settings.xml 一 
般 只 放 在 本 机 。 因 此 ， 在 settings.xml 中 配置 认证 信息 更 为 安全 。 


假设 需要 为 一 个 id 为 my-proj 的 仓库 配置 认证 信息 ， 编 辑 settings.xml 
文件 见 代码 清单 6-3: 


代码 清单 6-3 ”在 settings.xml 中 配置 仓库 认证 信息 


Maven 使 用 settings.xml 文 件 中 并 不 显而易见 的 servers 元 素 及 其 
server 了 于 元 素 配 置 仓库 认证 信息 。 代 码 清单 6-3 中 该 仓库 的 认证 用 户 名 为 
repo-user， 认 证 密码 为 repo-pwd。 这 里 的 关键 是 id 元 素 ，settings.xml 中 
server 元 素 的 id 必须 与 PCOM 中 需要 认证 的 repository 元 素 的 id 完全 一 致 。 
换 句 话说 ， 正 是 这 个 id 将 认证 信息 与 仓库 配置 联系 在 了 一 起 。 


6.4.2 ”部 署 至 远程 仓库 


在 第 6.3.4 广 中 提 到 ， 私 服 的 一 大 作用 是 部 署 第 三 方 构件 ， 包 括 组 
织 内 部 生成 的 构件 以 及 一 些 无 法 从 外 部 仓库 直接 获取 的 构件 。 无 论 是 
日 常 开 发 中 生成 的 构件 ， 还 是 正式 版 本 发 布 的 构件 ， 都 需要 部 署 到 仓 
库 中 ， 供 其 他 团队 成 员 使 用 。 


Maven 除 了 能 对 项 目 进行 编译 、 测 试 、 打 包 之 外 ， 还 能 将 项 目 生成 
的 构建 部 署 到 仓库 中 。 首 先 ， ee AE 
distributionManagement 元 素 见 代码 清单 6-4。 


代码 清单 6-4 ”在 POM 中 配置 构件 部 署 地 址 


project > 


<distributionManagement > 
<repository > 
<id>proj-releases </id> 
<name > Proj Release Repository < /name > 
<url> htt tp://192.168.1.100 /content /repositories /proj-releases < /url > 
< /repository > 
<snapshotRepository > 
<id>proj-snapshots < /id > 
O ry < /name > 


)/content /repositories/proj-snapshots < /url > 


distributionManagement & repository fsnapshotRepository FICA , 
前 者 表示 发 布 版 本 构件 的 仓库 ， 后 者 表示 快照 版 本 的 仓库 。 关 于 发 布 
版 本 和 快照 版 本 ， 第 6.5 节 会 详细 解释 。 这 两 个 元 素 下 都 需要 配置 id、 
name 和 url，id 为 该 远程 仓库 的 唯一 标识 ，name 是 为 了 方便 人 阅读 ， 关 
键 的 ul 表示 该 仓库 的 地 址 。 


往 远 程 仓库 部 署 构 件 的 时 候 ， 往 往 需 要 认证 。 配 置 认证 的 方式 已 
在 第 5.4 节 中 详细 阐述 ， 简 而 言 之 ， 就 是 需要 在 settings.xml 中 创建 一 个 
server 元 素 ， 其 id 与 仓库 的 id 匹配 ， 并 配置 正确 的 认证 信息 。 不 论 从 远 
程 仓 库 下 载 构件 ， 还 是 部 署 构件 至 远程 仓库 ， 当 需要 认证 的 时 候 ， 配 
置 的 方式 是 一 样 的 。 


配置 正确 后 ， 在 命令 行 运行 mvn clean deploy，Maven 就 会 将 项 目 
构建 输出 的 构件 部 署 到 配置 对 应 的 远程 仓库 ， 如 有 果 项 目 当前 的 版 本 是 
快照 版 本 ， 则 部 署 到 快照 版 本 仓库 地 址 ， 否 则 就 部 署 到 发 布 版 本 仓库 
地 址 。 如 下 十 部 署 一 个 快照 版 本 的 输出 : 


[INFO] --- maven-deploy-plugin:2.4:deploy (default-deploy) @ account-email -—— 
[INFO] Retrieving previous build number from proj-snapshots 


Uploading: 
http://192.168.1.100 /content /repositories /proj-snapshots /com/juven /mvnbook / 
account /account-email /1.0.0-SNAPSHOT /account-email-1.0.0-2 


0100103 .150936-2. jar 


6 KB uploaded at 727.8 KB/sec 
[INFO] Retrieving previous metadata from proj-snapshots 
[INFO] Uploading repository metadata for:'artifact com. juven.mvnbook. account :ac- 


count-email’ 
[INFO] Uploading project information for account-email 1.0.0-20100103.150936-2 
[INFO] Retrieving previous metadata from proj-snapshots 
[INFO] Uploading repository metadata for:'snapshot com. juven.mvnbook. account :ac= 
count -email :1.0.0-SNAPSHOT' 


(INFO) m= in eee 
[INFO] BUILD SUCCESS 


[INFO] --------------------------------------------------------- 


6.5 快照 版 本 


在 Maven 的 世界 中 ， 任 何 一 个 项 目 或 者 构件 都 必须 有 上 自己 的 版 
本 。 版 本 的 值 可 能 是 1.0.0、1.3-alpha-4、2.0、2.1-SNAPSHOT 或 者 2.1- 
20091214.221414-13。 其 中 ，1.0.0、1.3-alpha-4 和 2.0 是 稳定 的 发 布 版 
本 ， 而 2.1-SNAPSHOT 和 2.1-20091214.221414-13 是 不 稳定 的 快照 版 
本 o 


Maven 为 什么 要 区 分 发 布 版 和 快照 版 呢 ? 简单 的 1.0.0、1.2、2.1 等 
不 就 够 了 吗 ? 为 什么 还 要 有 2.1-SNAPSHOT， 甚 至 是 长 长 的 2.1- 
20091214.221414-13? 试想 一 下 这 样 的 情况 ， 小 张 在 开发 模块 A 的 2.1 
版 本 ， 该 版 本 还 未 正式 发 布 ， 与 模块 A 一 同 开发 的 还 有 模块 B， 它 由 小 
张 的 同事 季 MM 开 发 ，B 的 功能 依赖 于 A。 在 开发 的 过 程 中 ， 小 张 需要 
经 常 将 自己 最 新 的 构建 输出 ， 交 给 季 MM， 供 她 开发 和 集成 调试 ， 问 


题 是 ， 这 个 工作 如 何 进 行 呢 ? 


1 方案 一 


让 季 MM 目 己 签 出 模块 A 的 源码 进行 构建 。 这 种 方法 能 够 确保 季 
MM 得 到 模块 A 的 最 新 构件 ， 不 过 她 不 得 不 去 构建 模块 A。 多 了 一 些 版 
本 控制 和 Maven 操 作 还 不 算 ， 当 构建 A 失败 的 时 候 ， 她 会 古 一 头 筋 水 ， 
最 后 不 得 不 找 小 张 解决 。 显 然 ， 这 种 方式 是 低 效 的 。 


2.5 


重复 部 署 模块 A 的 2.1 版 本 供 季 MM 下 载 。 虽 然 小 张 能 够 保证 仓库 
中 的 构件 是 最 新 的 ， 但 对 于 Maven 来 说 ， 同 样 的 版 本 和 同样 的 坐标 就 
意味 着 同样 的 构件 。 因 此 ， 如 果 季 MM 在 本 机 的 本 地 仓库 包含 了 模块 A 
的 2.1 版 本 构件 ，Maven 束 不 会 再 对 照 远程 仓库 进行 更 狐 。 除 非 她 每 次 
执行 Maven 命 令 之 前 ， 清 除 本 地 仓库 ， 但 这 种 要 求 手 工 干预 的 做 法 显 
然 也 是 不 可 取 的 。 


9 方案 二 


不 停 更 新 版 本 2.1.1、2.1.2、2.1.3......。 首先 ， 小 张 和 季 MM 两 人 
都 需要 频繁 地 更 改 POM， 如 果 有 更 多 的 模块 依赖 于 模块 A， 束 会 涉及 
更 多 的 POM 更 改 ; 其 次 ， 大 量 的 版 本 其 实 仅仅 包含 了 微小 的 差异 ， 有 
时 候 是 对 版 本 号 的 滥用 。 


Maven 的 快照 版 本 机 制 就 是 为 了 解决 上 述 问题 。 在 该 例 中 ， 小 张 
只 需要 将 模块 A 的 版 本 设 定 为 2.1-SNAPSHOT， 然 后 发 布 到 私服 中 ， 在 
发 布 的 过 程 中 ，Maven 会 自动 为 构件 打上 时 间 戳 。 比 如 2.1- 
20091214.221414-13 就 表示 2009 年 12 月 14 日 22 点 14 分 14 秒 的 第 13 次 快 
照 。 有 了 该 时 间 礁 ，Maven 束 能 随时 找到 仓库 中 该 构件 2.1-SNAPSHOT 
版 本 最 新 的 文件 。 这 时 ， 季 MM 配置 对 于 模块 A 的 2.1-SNAPSHOT 版 本 
的 依赖 ， 当 她 构建 模块 B 的 时 候 ，Maven 会 自动 从 仓库 中 检查 模块 A 的 


2.1-SNAPSHOT 的 最 新 构件 ， 当 发 现 有 更 新 时 便 进行 下 载 。 默认 情况 
下 ，Maven 每 天 检查 一 次 更 新 (由 仓库 配置 的 updatePolicy 控 制 ， 见 第 
6.41) ， 用 户 也 可 以 使 用 命令 行 -U 参 数 强 制 让 Maven 检 查 更 新 ， 如 


mvn clean install-U ° 


基于 快照 版 本 机 制 ， 小 张 在 构建 成 功 之 后 才能 将 构件 部 署 至 仓 
库 ， 而 季 MM 可 以 完全 不 用 考虑 模块 A 的 构建 ， 并 且 她 能 确 你 随时 得 到 
模块 A 的 最 新 可 用 的 快照 构件 ， 而 这 一 切 都 不 需要 额外 的 手工 操作 。 


当 项 目 经 过 完善 的 测试 后 需要 发 布 的 时 候 ， 就 应 该 将 快照 版 本 更 
改 为 发 布 版 本 。 例 如 ， 将 2.1-SNAPSHOT 更 改 为 2.1， 表 示 该 版 本 已 经 
稳定 ， 且 只 对 应 了 唯一 的 构件 。 相 比 之 下 ，2.1-SNAPSHOT 往 往 对 应 
了 大 量 的 带 有 不 同时 间 礁 的 构件 ， 这 也 决定 了 其 不 稳定 性 。 


快照 版 本 只 应 该 在 组 织 内 部 的 项 目 或 模块 间 依赖 使 用 ， 因 为 这 
时 ， 组 织 对 于 这 些 快照 版 本 的 依赖 具有 完全 的 理解 及 控制 权 。 项 目 不 
应 该 依赖 于 任何 组 织 外 部 的 快照 版 本 依赖 ， 由 于 快照 版 本 的 不 稳定 
性 ， 这 样 的 依赖 会 造成 浴 在 的 危险 。 也 束 是 说 ， 即 使 项 目 构建 今天 是 
成 功 的， 由 于 外 部 的 快照 版 本 依赖 实际 对 应 的 构件 随时 可 能 变化 ， 项 
目的 构建 就 可 能 由 于 这 些 外 部 的 不 受 控制 的 因 聂 而 失败 。 


6.6 ”从 仓库 解析 依赖 的 机 制 


第 5 划 详 细 介 绍 了 Maven 的 依赖 机 制 ， 本 章 叉 深入 阐述 了 Maven 仓 
库 ， 这 两 者 是 如 何 具体 联系 到 一 起 的 呢 ? Maven 是 根据 怎样 的 规则 从 仓 
库 解 析 并 使 用 依赖 构件 的 呢 ? 


当 本 地 仓库 没有 依赖 构件 的 时 候 ，Maven 会 自动 从 远程 仓库 下 载 ; 
当 依赖 版 本 为 快照 版 本 的 时 候 ，Maven 会 自动 找到 最 新 的 快照 。 这 背后 
的 依赖 解析 机 制 可 以 概括 如 下 : 


1) 当 依 赖 的 范围 是 system 的 时 候 ，Maven 直 接 从 本 地 文件 系统 解 
析 构 件 。 


2) 根据 依赖 坐标 计算 仓库 路 径 后 ， 务 试 直接 从 本 地 仓库 寻找 构 
件 ， 如 有 果 发 现 相 应 构件 ， 则 解析 成 功 。 


3) 在 本 地 仓库 不 存在 相应 构件 的 情况 下 ， 如 采 依 赖 的 版 本 是 显 式 
的 发 布 版 本 构件 ， 如 1.2、2.1-beta-1 等 ， 则 思 历 所 有 的 远程 仓库 ， 发 现 
后 ， 下 载 并 解析 使 用 。 


A) 如 果 依 赖 的 版 本 是 RELEASE 或 者 LATEST， 则 基于 更 新 策略 读 
取 所 有 远程 仓库 的 元 数据 groupId/artifactId/maven-metadata.xml， 将 其 与 


本 地 仓库 的 对 应 元 数据 合并 后 ， 计 算出 RELEASE 或 者 LATEST 真 实 的 
值 ， 然 后 基于 这 个 真实 的 值 检 查 本 地 和 远程 仓库 ， 如 步骤 2) 和 3) 。 


5) 如 果 依 赖 的 版 本 是 SNAPSHOT， 则 基于 更 新 策略 读 取 所 有 远程 
仓库 的 元 数据 groupId/artifactId/version/maven-metadata.xml， 将 其 与 本 
地 仓库 的 对 应 元 数据 合并 后 ， 得 到 最 新 快照 版 本 的 值 ， 然 后 基于 该 值 
检查 本 地 仓库 ， 或 者 从 远程 仓库 下 载 。 


6) 如 果 最 后 解析 得 到 的 构件 版 本 是 时 间 惟 格式 的 快照 ， 如 1.4.1- 
20091104.121450-121， 则 复制 其 时 间 惟 格式 的 文件 至 非 时 间 戳 格式， 
如 SNAPSHOT， 并 使 用 该 非 时 间 惟 格式 的 构件 。 


当 依赖 的 版 本 不 明晰 的 时 候 ， 如 RELEASE、LATEST 和 
SNAPSHOT，Maven 束 需要 基于 更 新 远程 仓库 的 更 新 策略 来 检查 
新 。 在 第 6.4 节 提 到 的 仓库 配置 中 ， 有 一 些 配 置 与 此 有 关 : 首先 是 
<releases><enabled> 和 <snapshots><enabled> ， 只 有 仓库 开启 了 对 于 发 布 
版 本 的 支持 时 ， 才 能 访问 该 仓库 的 发 布 版 本 构件 信息 ， 对 于 快照 版 本 
也 是 同 理 ; 其 次 要 注意 的 是 <releases> 和 <snapshots> 的 子 元 素 
<updatePolicy>， 该 元 素 配 置 了 检查 更 新 的 频率 ， 每 日 检查 更 新 、 永 远 
检查 更 新 、 从 不 检查 更 新 、 自 定义 时 间 间 隔 检查 更 新 等 。 最 后 ， 用 户 
还 可 以 从 命令 行 加 入 参数 -U， 强 制 检查 更 新 ， 使 用 参数 后 ，Maven 就 会 
忽略 <updatePolicy> 的 配置 。 


当 Maven 检 查 完 更 新 策 略 ， 并 决定 检查 依赖 更 新 的 时 候 ， 就 需要 检 


查 仓 库 元 数据 maven-metadata.xml。 


回顾 一 下 前 面 提 到 的 RELEASE 和 LATEST 版 本 ， 它 们 分 别 对 应 了 
仓库 中 存在 的 该 构件 的 最 新 发 布 版 本 和 最 新 版 本 (包含 快照 ) ， 而 这 
两 个 “最 新 ”是 基于 groupId/artifactId/maven-metadata.xml 计 算出 来 的 ， 见 
代码 清单 6-5。 


代码 清单 6-5 ”基于 groupId 和 artifactId 的 maven-metadata.xml 


<?xml version = "1.0" encoding = "UTF-8"?> 
<metadata > 
groupid >org. sonatype. nexus < /groupld > 


<artifactId >nexus < /artifactId> 
<versioning > 
<latest >1.4.2-SNAPSHOT < /latest > 


eleas 1.4.0 </release > 
versions > 


4.0-S 


ersio 
1.4.0< 
1.4.0.1-SNAPSHOT < /version > 
4,1-SNAPSHOT < /version > 
1.4.2-SNAPSHOT < /version > 


< /meti a a> 


该 XML 文 件 列 出 了 仓库 中 存在 的 该 构件 所 有 可 用 的 版 本 ， 同 时 
latest 元 素 指向 了 这 些 版 本 中 最 新 的 那个 版 本 ， 该 例 中 是 1.4.2- 
SNAPSHOT ° 。 而 release 元 素 指 向 了 这 些 版 本 中 最 新 的 发 布 版 本 ， 该 例 
中 是 1.4.0。Maven 通 过 合并 多 个 远程 仓库 及 本 地 仓库 的 元 数据 ， 束 能 计 


算出 基于 所 有 仓库 的 latest 和 release 分 别 是 什么 ， 然 后 再 解析 具体 的 构 
人 


需要 注意 的 是 ， 在 依赖 声明 中 使 用 LATEST 和 RELEASE 是 不 推荐 
的 做 法 ， 因 为 Maven 随 时 都 可 能 解析 到 不 同 的 构件 ， 可 能 今天 LATEST 
是 1.3.6， 明 天 就 成 为 1.4.0-SNAPSHOT 了 ， 且 Maven 不 会 明确 告诉 用 户 
这 样 的 变化 。 当 这 种 变化 造成 构建 失败 的 时 候 ， 发 现 问题 会 变 得 比较 
困难 。RELEASE 因 为 对 应 的 是 最 新 发 布 版 构建 ， 还 相对 可 靠 ， 
LATEST 就 非常 不 可 靠 了 ， 为 此 ，Maven 3 不 再 支持 在 插件 配置 中 使 用 
LATEST 和 RELEASE。 如 采 不 设置 插件 版 本 ， 其 效 打 融和 RELEASE 一 
样 ，Maven 只 会 解析 最 新 的 发 布 版 本 构件 。 不 过 即使 这 样 ， 也 还 存在 潜 
在 的 问题 。 例 如 ， 某 个 依赖 的 1.1 版 本 与 1.2 版 本 可 能 发 生 一 些 接口 的 变 
化 ， 从 而 导致 当前 Maven 构 建 的 失败 。 


当 依赖 的 版 本 设 为 快照 版 本 的 时 候 ，Maven 也 需要 检查 更 新 ， 这 


时 ，Maven 会 检查 仓库 元 数据 groupId/artifactId/version/maven- 


metadata.xml， 见 代码 清单 6-6。 


代码 清单 6-6 ”基于 groupId、artifactId 和 version 的 maven- 


metadata.xml 


<?xml ver n=" 
Juspanatas 


oding = "UTF-8"? > 


jroupid >orc naty . nexus < /groupId 
artifactId >nexus artifactId > 
ersion >1.4.2-SNAPSHOT < /version 
rsloning > 

sn ot > 


snNApDSNC > 
< timestamp >20091214.221414 < /timestamp > 
<buildNumber >13 < /buildNumber > 
< / snapshot > 
< lastUpäated >20091214221558 < /lastUpdated > 
< / versioning > 
< /metadata > 


该 XML 文件 的 snapshot 元 素 包 含 了 timestamp 和 buildNumber 两 个 子 
TUR, DAH SIX 


一 快照 的 时 间 惟 和 构建 号 ， 基 于 这 两 个 元 素 可 以 
得 到 该 仓库 中 此 快照 的 最 新 构件 版 本 实际 为 1.4.2-20091214.221414- 


13。 通 过 合并 所 有 远程 仓库 和 本 地 仓库 的 元 数据 ，Maven 束 能 知道 所 有 
仓库 中 该 构件 的 最 新 快照 。 


最 后 ， 仓 库 元 数据 并 不 是 永远 正确 的 ， 有 时 候 当 用 户 发 现 无 法 解 
析 某 些 构件 ， 或 者 解析 得 到 错误 构件 的 时 候 ， 束 有 可 能 是 出 现 了 仓库 
元 数据 错误 ， 


这 时 就 需要 手工 地 ， 或 者 使 用 工具 (如 Nexus) 对 其 进行 
修复 。 


6.7 ”镜像 


如 果 仓 库 X 可 以 提供 仓库 Y 存 储 的 所 有 内 容 ， 那 么 就 可 以 认为 X 是 
Y 的 一 个 镜像 。 换 句 话 说， 任何 一 个 可 以 从 仓库 Y 获 得 的 构件 ， 都 能 够 
从 它 的 镜像 中 获取 。 举 个 例子 ， 
http:/maven.net.cn/content/groups/public/ 是 中 央 仓 库 
http://repo1.maven.org/maven2/ 在 中 国 的 镜像 ， 由 于 地 理 位 置 的 因素 ， 该 
镜像 往往 能 够 提供 比 中 央 仓 库 更 快 的 服务 。 因 此 ， 可 以 配置 Maven 使 用 
该 镜像 来 奉 代 中 央 仓 库 。 编 辑 settings.xml， 见 代码 清单 6-7。 


代码 清单 6-7 配置 中 央 仓 库 镜像 


etting 
mirre 
<mirror > 
ei > maven. net. /id> 
<name >one c E ene. central mirrors in China < /name > 
<url>http://maven.net.cn/content /groups/public/ < /url > 
<mirrorOf >central < /mirrorOf > 
< /mirror > 
< /mirrors > 
< /settings > 


该 例 中 ，<mirrorOf 人 的 值 为 central， 表 示 该 配置 为 中 央 仓 库 的 镑 
像 ， 任 何 对 于 中 央 仓 库 的 请 求 都 会 转 至 该 镜像 ， 用 户 也 可 以 使 用 同样 
的 方法 配置 其 他 仓库 的 镜像 。 另 外 三 个 元 素 id、name、ur 与 一 般 仓 库 


ACBICH, FNAB EAE PMA TT > PRA Bek © RAH, 
如 果 该 镜像 需要 认证 ， 也 可 以 基于 该 id 配置 仓库 认证 。 


天 于 镜像 的 一 个 更 为 肖 见 的 用 法 是 结合 私服 。 由 于 私服 可 以 代理 
任何 外 部 的 公共 仓库 (GARE) ， 因 此 ， 对 于 组 织 内 部 的 Maven 
用 户 来 说 ， 使 用 一 个 私服 地 址 就 等 于 使 用 了 所 有 需要 的 外 部 仓库 ， 这 
可 以 将 配置 集中 到 私服 ， 从 而 简化 Maven 本 吴 的 配置 。 在 这 种 情况 下 ， 
任何 需要 的 构件 都 可 以 从 私服 获得 ， 私 服 就 是 所 有 仓库 的 镜像 。 这 
时 ， 可 以 配置 这 样 的 一 个 镜像 ， 见 代码 清单 6-8。 


代码 清单 6-8 配置 使 用 私服 作为 镜像 


该 例 中 <mirrorOf> 的 值 为 星 号 ， 表 示 该 配置 是 所 有 Maven 仓 库 的 镜 
像 ， 任 何 对 于 远程 仓库 的 请 求 都 会 被 转 至 http:/192.168.1.100/maven2/。 
如 果 该 镜像 仓库 需要 认证 ， 则 配置 一 个 id 为 internal-repository 的 <server> 
即 可 ， 详 见 第 5.47。 


为 了 满足 一 些 复杂 的 需求 ，Maven 还 文 持 更 高 级 的 镜像 配置 ; 
-<mirrorOf>*</mirrorOf>: 匹配 所 有 远程 仓库 ° 


-<mirrorOf>external: *</mirrorOf>: 匹配 所 有 远程 仓库 ， 使 用 
localhost 的 除外 ， 使 用 file: /协议 的 除外 。 也 就 是 说 ， 匹 配 所 有 不 在 本 
机 上 的 远程 仓库 。 


-<mirrorOf>repol, repo2</mirrorOf>: 匹配 仓库 repo1 和 repo2， 使 


用 喜 号 分 隅 多 个 远程 仓库 。 


-<mirrorOf>*, ! repol</mirrorOf>: 匹配 所 有 远程 仓库 ，repol 除 
外 ， 使 用 感叹 号 将 仓库 从 匹配 中 排除 。 


需要 注意 的 是 ， 由 于 镜像 仓库 完全 屏蔽 了 被 镜像 仓库 ， 当 镜像 仓 
库 不 稳定 或 者 停止 服务 的 时 候 ，Maven 仍 将 无 法 访问 被 镜像 仓库 ， 因 而 
将 无 法 下 载 构件 。 


6.8 仓库 搜索 服务 


使 用 Maven 进 行 日 溃 开 发 的 时 候 ， 一 个 稍 见 的 问题 号 定 如 何 寻 找 
需要 的 依赖 ， 我 们 可 能 只 知道 需要 使 用 类 库 的 项 目 名 称 ， 但 添加 
Maven 依 赖 要 求 提供 确切 的 Maven 和 坐标 。 这 时 ， 就 可 以 使 用 仓库 搜索 
服务 来 根据 关键 字 得 到 Maven 和 坐标 。 本 市 介绍 几 个 常用 的 、 功 能 强大 
的 公共 Maven 仓 库 搜索 服务 。 


6.8.1 Sonatype Nexus 


地 址 : http://repository.sonatype.org/ 


Nexus 是 当前 最 流行 的 开源 Maven 仓 库 管理 软件 ， 本 书后 面 会 有 专 
门 的 草 和 讲述 如 何 使 用 Nexus 假 设 私服 。 这 里 要 介绍 的 是 Sonatype 架 设 


的 一 个 公共 Nexus 仓 库 实 例 。 


Nexus 提 供 了 关键 子 搜索 、 类 名 搜索 、 坐 标 搜 索 、 校 验 和 搜索 等 功 
能 。 搜 索 后 ， 页 面 清晰 地 列 出 了 结果 构件 的 坐标 及 所 属 仓库 。 用 户 可 
以 直接 下 载 相 应 构件 ， 还 可 以 直接 复制 已 经 根据 坐标 目 动 生 成 的 XML 
依赖 声明 ， 见 图 6-3。 


= Sonatype | RSO 


& | Welcome =|| Search x 


Log in 
Sonatype Nexus™ Team Edition, Version: 1.7.2 


Keyword Search + | activamq 


A 


Version 


Artifact Search al Keyword Search Artifact Download | 
adven \2 Cassname Search activemg Latest: 4.0-M3 (Show All Versions) pom, jar = 
Annai samih, GAY Search adivemq-ws-onltypes Latest: dev-1 (Show All Versions) pom, jar 国 | 
Checksum Search activemg-ws Latest: 3,1-M2 (Show åll Versions) pom, jar 
Mews/Rapositories * a ec activema-ans Latest: 2.1 (Show All Versions) pom, jar 
Repositories activemg-tools Latest 2.1 (Show All Versions) pom, jar 
Hel = acivemg activemq-spring Latest 2.1 (Show All Versions) pom, jar 
activemg activema-transport-gnet Latest: 1.5 (Show All Versions) pom, jar - 
Dspkying Top 58 records x Clear Rasuts 
. Z Refresh | Viewing Repository: | Central Pro. | Maven Information | Artfact Information | Artifact Metadata | Archive Browser | 
二 ai = == 
FE 
ww (3.2 Artfact: activemg 
国画 32M1 Version: 4.0-M3 
@ Cod 321 Extension: jar 
Wg 3.22 
wy 3.23 XML: <dependency> 
| 324 <groupld>activemq</groupld> 
aga <artifactId>activema</artifectId> 
MIr EAEE] <verson>4.0-M3</verson> 
a soma } </dependency> 
agsia 
| pactivema-4.0-3 jar 
| (gg felease-1.1-G1M3 一 
@ (qyrelease-1 2 
p (gq release-1.3 
w (gg feloase-1.4 
| @ fqrelease-15 
| @ (gy release-20 | 
jhttps://repository.sonatype org/index.htmi= mA | 


图 6-3 Sonatype Nexus 仓 库 搜 索 服 务 


6.8.2 Jarvana 


地 址 : http://www.jarvana.com/jarvana/ 


Jarvana 提 供 了 基于 关键 字 、 类 名 的 搜索 ， 构 件 下 载 、 依 赖 声 明 片 
段 等 功能 也 一 应 俱全 。 值 得 一 提 的 是 ，Jarvana 还 支持 浏览 构件 内 部 的 
内 容 。 此 外 ，Jarvana 还 提供 了 便捷 的 Java 文 档 浏览 的 功能 。Jarvana 的 搜 
索 结 来 页 面 如 图 6-4 所 示 。 


Search Browse JavadocsNEW More 
ARVANA ie 
activemq 
Project Search: Results 1 - 100 of 559 for "activemgq". 
Result Page: 123456 


Archive Details Group Id Artifact Id 
activemq-release-2.1.jar < activemg “& activemq 
activemq activemq 
activemg-release-1.5.jar activemq activemq 
activemg-release-1.4.jar activemq activemq 
ì activemg-release-1.3 jar activemq activemq 
activemg-release-1.2.jar activemq activemq 
activemg-release-1.1-G1M3.jar activemq activemgq release-1.1-G1M3 
activemg-4.0-M3.jar activemq activemq 4.0-M3 
activemg-4.0-M2.jar activemg activemq 4.0-M2 
activemg-4.0-M1 jar activemq activemq 
activemg-3.2.4.jar activemq activemq 
activemg-3.2.3.jar activemg activemq 
activemq-3.2.2.jar activemg activemq 
14 &} &) 40 adivemg-3.2.1jar activemq activemq 
15 49 a 者 全 activemq-3.2-M1.jar activemq activemq 
16 耐量 呵 acivemq-3.2.jar activemq activemq 


图 6-4 Jarvana 仓 库 搜 索 服 
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6.8.3 MVNbrowser 


地 址 : http://www.mvnbrowser.com 


MYVNbrowser 只 提供 关键 字 搜 索 的 功能 ， 除 了 提供 基于 坐标 的 依赖 
声明 代码 片段 等 基本 功能 之 外 ，MVNbrowser 的 一 大 特色 就 是 ， 能 够 告 
诉 用 户 该 构件 的 依赖 于 其 他 哪些 构件 (Dependencies) 以 及 该 构件 被 哪 


些 其 他 构件 依赖 (Referenced By) 


如 图 6-5 所 示 。 


Ey > 


2 activemg 


Apache Hotel Las 
Vegas 

Find Deals, Read 
Raviews from Real 


People. Get the Truth. 


Pns se 


=or,.com 


Le arn Financial 


Step- by- Step Self 
Study Program Build 
DCF, LBO, M&A, 
ip CS 

nai WallStreetPrep.co 
Free Horoscope 
Re Reading 
Love, Money, Career, 
Family, Chance 
Discover your Future 
now. 100% Free 


AboutAstro.com/horascope 


Service Manual 
Free Rapair Manuals 
and Support. Service 
Manual 


Fixya.com)/Service+Ma 


ActiveMQ :: Assembly 


ActweWIO Assembly creates an ActiveMQ distribution 
Prowmded by Protique, Ltd (^tt otiqu n) 


Pom snippet 


<dependency> 
<groupId>activemg</groupId» 
zartifactId>activemyć¿/artifactId» 
<version>4.0-M3</version> 
</dependency> 


The Bell Jar by Plath 
Study Guide: Summary, Analysis, Themes, Characters, Essays: $7.99 
BookReos.com 


| Versions Dependencies (Files [Referenced By |Repositones Licenses 


图 6-5 MVNbrowser 仓 库 搜索 服务 
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Tutorial 
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6.8.4 MvVNrepository 


地 址 : http://mvnrepository.com/ 


MVNrepository 的 界面 比较 清新 ， 它 提供 了 基于 关键 字 的 搜索 、 依 
赖 声 明代 码 厂 段 、 构 件 下 载 、 依 赖 与 被 依赖 关系 信 息 、 构 件 所 含 包 信 


息 等 功能 


。MVNrepository 还 能 提供 一 个 简单 的 图 表 ， 显 示 某 个 构件 各 


版 本 间 的 大 小 变化 。MVNrepository 的 页 面 如 图 6-6 所 示 。 


MVNREPOSITORY 


Repository 


e Plugins 
e Tag Cloud 


Artifacts/ Jars 
75,000 


50,000 
25,000 
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Artifacts /Year 

Feeds 


Popular Tags 
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annotations ant api 
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asynchronously beans 
r Lied 


actiyeng Search 
Search by group, artifact or description. 
E.g: toglib, =pring, hibernate 


home » ord.apache.activemng » activema-core 
Ads by Google 
ActiveMQ Reference 

China Chat uide 

hae Your Dan — Right Now Absolutely Free! Register Today. omprehensive guide 

303, cory OnLineDating at helps you learn 
Ads by Googles configure 

ActiveMQ 


www. ttmealutions.com 


ActiveMQ :: Core 


The ActiveMQ Message Broker and Client implementations 
tags: 
Available versions 


Version Download 


图 6-6 MVNrepository 仓 库 搜 索 服 务 


6.8.5 ”选择 合适 的 仓库 搜索 服务 


上 述 介绍 的 四 个 仓库 搜索 服务 都 代理 了 主流 的 Maven 公 共 仓 库 ， 
如 central、JBoss、Java.net 等 。 这 些 服 务 都 提供 了 完备 的 搜索 、 浏 贤 、 
下 载 等 功能 ， 区 别 只 在 于 页 面 风格 和 和 额外 功能 。 例 如 ，Nexus 提 供 了 
其 他 三 种 服务 所 没有 的 基于 校 验 和 搜索 的 功能 。 用 户 可 以 根据 喜好 和 
特殊 需要 选择 最 合适 目 己 的 搜索 服务 ， 当 然 ， 也 可 以 综合 使 用 所 有 这 


些 服务 。 


6.9 小结 


本 草 深 入 阐述 了 仓库 这 一 Maven 核 心 概 念 。 目 先 介 绍 了 仓库 的 由 
来 ; 接着 直接 剖析 了 一 段 Maven 源 码 ， 介 绍 仓库 的 布局 ， 以 方便 读者 
将 仓库 与 实际 文件 联系 起 来 ， 而 仓库 的 分 类 这 一 部 分 则 分 别 介绍 了 本 
地 仓库 、 远 程 仓库 、 中 央 仓 库 以 及 私服 等 概念 ， 基 于 这 些 概 念 ， 又 详 
细 介 绍 了 仓库 的 配置 ， 在 此 基础 上 ， 我 们 再 深入 仓库 的 内 部 工作 机 
制 ， 并 同时 解释 了 Maven 中 快照 的 概念 。 本 章 还 解释 了 镜像 的 概念 及 
用 法 。 最 后 ， 本 章 介绍 了 一 些 常 用 的 仓库 搜索 服务 ， 以 方便 读者 的 日 
常 开 发 工作 。 


第 7 章 ”生命 周期 和 插件 


本 章 内 容 
. 何 为 生命 周期 
.生命 周期 详解 
插件 目标 
.插件 绑 定 
.插件 配置 
获取 插件 信息 
.从 命令 行 调用 插件 
插件 解析 机 制 
小 结 


除了 坐标 、 依 赖 以 及 仓库 之 外 ，Maven 另 外 两 个 核心 概念 是 生命 
周期 和 插件 。 在 有 关 Maven 的 日 常 使 用 中 ， 命 令 行 的 输入 往往 就 对 应 
了 生命 周期 ， 如 mvn package 束 表示 执行 默认 生命 周期 阶段 package 。 
Maven 的 生命 周期 是 抽象 的 ， 其 实际 行为 都 由 插件 来 完成 ， 如 package 


阶段 的 任务 可 能 就 会 由 maven-jar-plugin 完 成 。 生 命 周 期 和 插件 两 者 协 
同 工 作 ， 蜜 不可分， 本 章 对 它们 进行 深入 介绍 。 


7.1 何 为 生命 周期 


在 Maven 出 现 之 前 ， 项 目 构建 的 生命 周期 就 已 经 存在 ， 软 件 开发 人 
员 每 天 都 在 对 项 目 进行 清理 、 编 译 、 测 试 及 部 署 。 虽 然 大 家 都 在 不 停 
地 做 构建 工作 ， 但 公司 和 公司 间 、 项 目 和 项 目 间 ， 往 往 使 用 不 同 的 方 
式 做 类 似 的 工作 。 有 的 项 目 以 手工 的 方式 在 执行 编译 测试 ， 有 的 项 目 
写 了 目 动 化 脚本 执行 编译 测试 。 可 以 想象 的 是 ， 虽 然 各 种 手工 方式 十 
分 类 似 ， 但 不 可 能 完全 一 样 ， 同 样 地 ， 对 于 自动 化 脚本 ， 大 家 也 是 各 
写 各 的 ， 能 满足 上 自身 需求 即 可 ， 换 个 项 目 就 需要 重头 再 来 。 


Maven 的 生命 周期 束 古 为 了 对 所 有 的 构建 过 程 进行 抽象 和 统一 。 


Maven 从 大 量 项 目 和 构建 工具 中 学 习 和 反思 ， 然 后 总 结 了 一 套 高 度 完善 
的 、 易 扩展 的 生命 周期 。 这 个 生命 周期 包含 了 项 目的 清理 、 初 始 化 、 
编译 、 测 试 、 打 包 、 集 成 测试 、 验 证 、 部 署 和 站 点 生成 等 几乎 所 有 构 
建 步 又 。 也 就 是 说 ， 几 乎 所 有 项 目的 构建 ， 都 能 映射 到 这 样 一 个 生命 
周期 上 。 


Maven 的 生命 周期 是 抽象 的 ， 这 意味 着 生命 周期 本 身 不 做 任何 实际 
的 工作 ， 在 Maven 的 设计 中 ， 实 际 的 任务 (如 编译 源 代码 ) 都 交 由 插件 
来 完成 。 这 种 思想 与 设计 模式 中 的 模板 方法 (Template Method) 非常 
相似 。 模 板 方法 模式 在 父 类 中 定义 算法 的 整体 结构 ， 子 类 可 以 通过 实 
现 或 者 重 写 父 类 的 方法 来 控制 实际 的 行为 ， 这 样 既 保证 了 算法 有 足够 


的 可 扩展 性 ， 又 能 够 严格 控制 算法 的 整体 结构 。 如 下 的 模板 方法 抽象 
类 能 够 很 好 地 体现 Maven 生 命 周期 的 概念 ， 见 代码 清单 7-1。 
代码 清单 7-1 模拟 生命 周期 的 模板 方法 抽象 类 


initialize(); 


compile (); 
-zest (); 

)aCKacee 
integrationT ) 
deploy () 


protected abstract void initialize(); 
protected abstract void compile(); 
protected abstract void test (); 


protected abstract void packagee (}; 


这 段 代码 非常 简单 ，build () 方法 定义 了 整个 构建 的 过 程 ， 依 次 
初始 人 化、 编译、 测试 、 打 包 (由 于 package 与 Java 关 键 字 冲突 ， 这 里 使 
用 了 单词 packagee) 、 集 成 测试 和 部 署 ， 但 是 这 个 类 中 没有 具体 实现 初 

化 、 编 译 、 测 试 等 行为 ， 它 们 都 交 由 子 类 去 实现 。 


虽然 上 述 代 码 和 Maven 实 际 代码 相去 甚 远 ，Maven 的 生命 周期 包含 
更 多 的 步骤 和 更 复杂 的 逻辑 ， 但 它们 的 基本 理念 是 相同 的 。 生 命 周 期 


抽象 了 构建 的 各 个 步 又， 定义 了 它们 的 次 序 ， 但 没有 提供 有 具体 实现 。 
那么 谁 来 实现 这 些 步 又 呢 ? 不 能 让 用 户 为 了 编译 而 写 一 推 代码， 为 了 
测试 又 写 一 堆 代 码 ， 那 不 就 成 了 大 家 在 重复 发 明 轮 子 吗 ? Maven 当 然 必 
须 考 虑 这 一 点 ， 因 此 它 设 计 了 插件 机 制 。 每 个 构建 步骤 都 可 以 绑 定 一 
个 或 者 多 个 插件 行为 ， 而 且 Maven 为 大 多 数 构建 步骤 编写 并 绑 定 了 默认 
插件 。 例 如 ， 针 对 编译 的 插件 有 maven-compilerplugin， 针 对 测试 的 插 
件 有 maven-surefire-plugin 等 。 虽 然 在 大 多 数 时 间 里 ， 用 户 几 乎 都 不 会 
觉察 到 插件 的 存在 ， 但 实际 上 编译 是 由 maven-compiler-plugin 完 成 的 ， 
而 测试 是 由 maven-surefire-plugin 完 成 的 。 当 用 户 有 特殊 需要 的 时 候 ， 
也 可 以 配置 插件 定制 构建 行为 ， 甚 至 自己 编写 插件 。 生 命 周期 和 插件 
的 关系 如 图 7-1 所 示 。 


> | a jy wie || He | we | 


ia, Pr. 


maven-compiler-plugin maven-surefire-plugin 


图 7-1 生命 周期 和 插件 的 关系 


Maven 定 义 的 生命 周期 和 插件 机 制 一 方面 保证 了 所 有 Maven 项 目 有 
一 致 的 构建 标准 ， 另 一 方面 又 通过 默认 插件 简化 和 稳定 了 实际 项 目的 
构建 。 此 外 ， 该 机 制 还 提供 了 足够 的 扩展 空间 ， 用 户 可 以 通过 配置 现 
有 插件 或 者 自行 编写 插件 来 自 定 义 构建 行为 。 


7.2 生命 周期 详解 


到 目前 为 止 ， 本 书 只 是 介绍 了 Maven 生 命 周 期 背后 的 指导 思想 ， 
要 想 熟 练 地 使 用 Maven， 还 必须 详细 了 人 解 其 生命 周期 的 具体 定义 和 使 
AIAS 


7.21 三 套 生 命 周期 


初学 者 往往 会 以 为 Maven 的 生命 周期 是 一 个 整体 ， 其 实 不 然 ， 
Maven 拥 有 三 父 相 互 独立 的 生命 周期 ， 它 们 分 别 为 clean、default 和 
site。clean 生 命 周 期 的 目的 是 清理 项 目 ，default 生 命 周 期 的 目的 征 构建 
项 目 ， 而 site 生 命 周 期 的 目的 是 建立 项 目 站 点 。 


每 个 生命 周期 包含 一 些 阶段 (phase) ， 这 些 阶段 是 有 顺序 的 ， 并 
且 后 面 的 阶段 依赖 于 前 面 的 阶段 ， 用 户 和 Maven 最 直接 的 交互 方式 就 
是 调用 这 些 生命 周期 阶段 。 以 clean 生 命 周 期 为 例 ， 它 包含 的 阶段 有 
pre-clean、clean 和 post-clean。 当 用 户 调 用 pre-clean 的 上 时候， 只 有 pre- 
clean 阶 段 得 以 执行 ， 当 用 户 调用 dlean 的 时 候 ，pre-clean 和 和 clean 阶 段 会 
得 以 顺序 执行 ， 当 用 户 调用 post-clean 的 上 时候，pre-clean、clean 和 post- 
clean 会 得 以 顺序 执行 。 


较 之 于 生命 周期 阶段 的 前 后 依赖 关系， 三 套 生 命 周 期 本 映 是 相互 
独立 的 ， 用 户 可 以 仅仅 调用 clean 生 命 周 期 的 某 个 阶段 ， 或 者 仅仅 调用 
default 生 命 周 期 的 某 个 阶段 ， 而 不 会 对 其 他 生命 周期 产生 任何 影响 。 
例如 ， 当 用 户 调用 clean 生 命 周 期 的 clean 阶 段 的 时 候 ， 不 会 触发 default 
生命 周期 的 任何 阶段 ， 反 之 亦 然 ， 当 用 户 调 用 default 生 命 周 期 的 
compile 阶 段 的 时 候 ， 也 不 会 触发 clean 生 命 周 期 的 任何 阶段 。 


7.2.2 ”clean 生命 周期 


clean 生 命 周 期 的 目的 是 清理 项 目 ， 它 包含 三 个 阶段 : 
1) pre-clean 执 行 一 些 清理 前 需要 完成 的 工作 。 
2) clean 清 理 上 一 次 构建 生成 的 文件 。 


3) post-clean 执 行 一 些 清理 后 需要 完成 的 工作 。 


7.2.3 default 生命 周期 


default 生 命 周期 定义 了 真正 构建 时 所 需要 执行 的 所 有 步 又 ， 它 是 
所 有 生命 周期 中 最 核心 的 部 分 ， 其 包含 的 阶段 如 下 ， 这 里 笔者 只 对 重 
要 的 阶段 进行 解释 : 


«validate 
‘initialize 


‘generate-sources 


:process-sources 处 理 项 目 主 资源 文件 。 一 般 来 说 ， 是 对 
src/main/resources 目 孙 的 内 容 进 行 变量 替换 等 工作 后 ， 复 制 到 项 目 输出 
的 主 classpath 目 孙 中 。 


“generate-resources 


“PrOCess-resources 


compile 编 译 项 目的 主 源码 。 一 般 来 说 ， 是 编译 src/main/java 目 录 
下 的 Java 文 件 至 项 目 输出 的 主 classpath 目 未 中 。 


:process-classes 


‘generate-test-sources 


ne 目测 试 资源 文件 。 一 般 来 说 ， 是 对 
src/test/resources 目 录 的 内 容 进 行 变 量 奉 换 等 工作 后 ， 复 制 到 项 目 输出 
的 测试 classpath 目 录 中 。 


“generate-test-resources 


“process-test-resources 


test-compile 编 译 项 目的 测试 代码 。 一 般 来 说 ， 是 编译 src/test/java 
目 孙 下 的 Java 文 件 至 项 目 输 出 的 测试 classpath 目 了 永 中 。 


-process-test-classes 

test 使 用 单元 测试 框 染 运行 测试 ， 测 试 代码 不 会 袖 打 包 或 部 署 。 
-prepare-package 

-package 接 受 编译 好 的 代码 ， 打 包 成 可 发 布 的 格式 ， 如 JAR。 
-pre-integration-test 

-integration-test 


‘post-integration-test 


‘verify 
"install 将 包 安 闭 到 Maven 本 地 仓库 ， 供 本 地 其 他 Maven 项 日 使 用 。 


-deploy 将 最 终 的 包 复 制 到 远程 仓库 ， 供 其 他 开发 人 员 和 Maven 项 


目 使 用 。 
对 于 上 述 未 加 解释 的 阶段 ， 读 者 也 应 该 能 够 根据 名 字 大 概 猜 到 其 
可 以 参阅 官方 的 解 


用 途 ， 者 想 了 解 进 一 步 的 这 些 阶段 的 详细 信息 
释 : http://maven.apache.org/guides/introduction/introduction-to-the- 


lifecycle.html ° 


7.2.4 site 生命 周期 


site 生 命 周期 的 目的 是 建立 和 发 布 项 目 站 点 ，Maven 能 够 基于 POM 
所 包含 的 信息 ， 目 动 生成 一 个 友好 的 站 点 ， 方 便 团 队 交 流 和 发 布 项 目 
信息 。 该 生命 周期 包含 如 下 阶段 : 


-pre-site 执 行 一 些 在 生成 项 目 站 点 之 前 需要 完成 的 工作 。 


Site 生成 项 目 站 点 文档 。 


.post-site 执 行 一 些 在 生成 项 目 站 点 之 后 需要 完成 的 工作 。 


site-deploy 将 生成 的 项 目 站 点 发 布 到 服务 右上 。 


7.2.5 ”命令 行 本 生命 周期 


pmi 
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期 阶段 。 需 要 注意 的 是 ， 各 个 生命 周期 是 相互 独立 的 ， 而 一 个 生命 周 
期 的 阶段 是 有 前 后 依赖 关系 的 。 下 面 以 一 些 常 见 的 Maven 命 令 为 例 ， 
解释 其 执行 的 生命 周期 阶段 : 


:$mvn clean: 该 命令 调用 clean 生 命 周期 的 clean 了 阶段。 实际 执行 


的 阶段 为 dean 生 命 周 期 的 pre-clean 和 clean 阶 段 。 


.中 mvn test: 该 命令 调用 default 生 命 周 期 的 test 阶 段 。 实 际 执行 的 
阶段 为 default 生 命 周 期 的 validate、initialize 等 ， 直 到 test 的 所 有 阶段 。 
这 也 解释 了 为 什么 在 执行 测试 的 时 候 ， 项 目的 代码 能 够 自动 得 以 编 


译 。 


-Smvn clean install: 该 命令 调用 clean 生 命 周 期 的 clean 阶 段 和 
default 生 命 周 期 的 install 阶 段 。 实 际 执行 的 阶段 为 clean 生 命 周 期 的 pre- 
clean 、clean 阶 段 ， 以 及 default 生 命 周期 的 从 validate 人 至 instal 的 所 有 阶 
段 。 该 命令 结合 了 两 个 生命 周期 ， 在 执行 真正 的 项 目 构建 之 前 清理 项 
目 是 一 个 很 好 的 实践 。 


-$ mvn clean deploy site-deploy: 该 命令 调用 clean 生 命 周 期 的 Clean 
阶段 、default 生 命 周期 的 deploy 阶 段 ， 以 及 site 生 命 周 期 的 site-deploy 阶 
段 。 实 际 执行 的 阶段 为 dean 生 命 周 期 的 pre-clean、clean 阶 段 ，default 
生命 周期 的 所 有 阶段 ， 以 及 site 生 命 周 期 的 所 有 阶段 。 该 命令 结合 
Maven 所 有 三 个 生命 周期 ， 且 deploy 为 default 生 命 周 期 的 最 后 一 个 阶 
Ez, site-deploy 为 site 生 命 周 期 的 最 后 一 个 阶段 。 


由 于 Maven 中 主要 的 生命 周期 阶段 并 不 多 ， 而 常用 的 Maven 命 令 
实际 都 是 基于 这 些 阶段 简单 组 合 而 成 的 ， 因 此 只 要 对 Maven 生 命 周 期 
有 一 个 基本 的 理解 ， 读 者 就 可 以 正确 而 熟练 地 使 用 Maven 命 令 。 


7.3 ”插件 目标 


在 进一步 详 述 插件 和 生命 周期 的 绑 定 关系 之 前 ， 必 须 先 了 解 插件 
目标 (Plugin Goal) 的 概念 。 我 们 知道 ，Maven 的 核心 仅仅 定义 了 抽 
象 的 生命 周期 ， 具 体 的 任务 是 交 由 插件 完成 的 ， 播 件 以 独立 的 构件 形 
式 存在 ， 因 此 ，Maven 核 心 的 分 发 包 只 有 不 到 3MB 的 大 小 ，Maven 会 
在 需要 的 时 候 下 载 并 使 用 插件 。 


对 于 插件 本 身 ， 为 了 能 够 复 用 代码 ， 它 往往 能 够 完成 多 个 任务 。 
例如 maven-dependency-plugin， 它 能 够 基于 项 目 依赖 做 很 多 事情 。 它 
能 够 分 析 项 目 依赖 ， 帮 助 找 出 湾 在 的 无 用 依赖 ， 它 能 够 列 出 项 目的 依 
赖 树 ， 帮 助 分 析 依 赖 来 源 ， 它 能 够 列 出 项 目 所 有 已 解析 的 依赖 ， 等 
等 。 为 每 个 这 样 的 功能 编写 一 个 独立 的 插件 显然 古 不 可 取 的 ， 因 为 这 
些 任务 背后 有 很 多 可 以 复 用 的 代码 ， 因 此 ， 这 些 功 能 案 集 在 一 个 插件 


， 每 个 功能 忠 古 一 个 插件 目标 。 


是 


maven-dependency-plugin 有 十 多 个 目标 ， 每 个 目标 对 应 了 一 个 功 
能 ， 上 述 提 到 的 几 个 功能 分 别 对 应 的 插件 目标 为 dependency: 
analyze ` dependency: tree 和 dependency: list。 这 是 一 种 通用 的 写法 ， 
冒号 前 面 是 插件 前 绥 ， 冒 号 后 面 是 该 插件 的 目标 。 类 似 地 ， 还 可 以 写 
出 compiler: compile (这 是 maven-compiler-plugin 和 的 compile 目 标 ) 和 


surefire: test 〈 这 是 maven-surefire-plugin 的 test 目 标 ) ° 


7A 插件 绑 定 


Maven 的 生命 周期 与 插件 相互 绑 定 ， 用 以 完成 实际 的 构建 任务 。 
具体 而 言 ， 是 生命 周期 的 阶段 与 插件 的 目标 相互 绑 定 ， 以 完成 时 个 具 
体 的 构建 任务 。 例 如 项 目 编译 这 一 任务 ， 它 对 应 了 default 生 命 周 期 的 
compile 这 一 阶段 ， 而 maven-compiler-plugin 这 一 插件 的 compile 目 标 能 
够 完成 该 任务 。 因 此 ， 将 它们 绑 定 ， 就 能 实现 项 目 编译 的 目的 ， 如 图 


7-2 所 示 。 


default 


maven-compiler-plugin 


7-2 生命 周期 阶段 与 插件 目标 绑 定 


741 内 置 绑 定 


为 了 能 让 用 户 几 乎 不 用 任何 配置 就 能 构建 Maven 项 目 ，Maven 在 核 
心 为 一 些 主 要 的 生命 周期 阶段 绑 定 了 很 多 插件 的 目标 ， 当 用 户 通过 命 
令 行 调用 生命 周期 阶段 的 时 候 ， 对 应 的 插件 目标 就 会 执行 相应 的 任 


务 。 


clean 生 命 周 期 仅 有 pre-clean、clean 和 post-clean 三 个 阶段 ， 其 中 的 
clean 与 maven-clean-plugin: clean 绑 定 。maven-clean-plugin 仅 有 clean 这 
一 个 目标 ， 其 作用 残 是 删除 项 目的 输出 目 孙 。clean 生 命 周 期 阶段 与 皇 
件 目标 的 绑 定 关系 如 表 7-1 所 示 。 


site 生 命 周 期 有 pre-site、site、post-site 和 site-deploy 四 个 阶段 ， 其 
中 ，site 和 maven-site-plugin: site 相 互 绑 定 ，site-deploy 和 maven-site- 
plugin: depoy 相 互 绑 定 。maven-site-plugin 有 很 多 目标 ， 其 中 ，site 目 标 
用 来 生成 项 目 站 点 ，deploy 目 标 用 来 将 项 目 站 点 部 团 到 远程 服务 右上 。 
site 生 命 周 期 阶段 与 插件 目标 的 绑 定 天 系 如 表 7-2 所 示 。 


表 7-1 clean 和 生命 周期 阶段 与 插件 


生命 周期 阶段 插件 目标 
pre-clean 
clean maven-clean-plugin ; clean 


post-clean 


表 7-2 site 生命 周期 阶段 与 插件 


生命 周期 阶段 插件 目标 
pre-site 
site maven-site-plugin ; site 
post-site 
site-deploy maven-site-plugin ; deploy 


相对 于 clean 和 site 生 命 周期 来 说 ，default 生 命 周 期 与 插件 目标 的 绑 
定 关系 就 显得 复杂 一 些 。 这 是 因为 对 于 任何 项 目 来 说 ， 例 如 jar 项 目 和 
war 项 目 ， 它 们 的 项 目 清理 和 站 点 生成 任务 是 一 样 的 ， 不 过 构建 过 程 会 
有 区 别 。 例 如 jar 项 目 需要 打 成 JAR 包 ， 而 war 项 目 需要 打 成 WAR 包 。 


由 于 项 目的 打包 类 型 会 影响 构建 的 具体 过 程 ， 因 此 ，default 生 命 周 
期 的 阶段 与 插件 目标 的 绑 定 关系 由 项 目 打包 类 型 所 决定 ， 打 包 类 型 是 
通过 POM 中 的 packaging 元 系 定 义 的 ， 具 体 可 回顾 第 5.2 广 。 最 第 匈 、 最 
重要 的 打包 类 型 是 jar， 它 也 是 默认 的 打包 类 型 。 基 于 该 打包 类 型 的 项 
目 ， 其 default 生 命 周期 的 内 置 插件 绑 定 关系 及 具体 任务 如 表 7-3 所 示 。 


表 7-3 default 生 命 周 期 的 内 置 插件 绑 定 关系 及 具体 任务 (打包 类 型 ; 


jar) 
生命 周期 阶段 插件 目标 执行 任务 
process-resources maven-resources-plugin ; resources 复制 主 资源 文件 至 主 输出 目录 
compile maven-compiler-plugin ; compile 编译 主 代码 至 主 输出 目录 
process-test-resources maven-resources-plugin :testResources 复制 测试 资源 文件 至 测试 输出 目录 
test-compile maven-compiler-plugin :testCompile 编译 测试 代码 至 测试 输出 目录 
test maven-surefire-plugin :test 执行 测试 用 例 
package maven-jar-plugin ; jar 创建 项 目 jar 包 
install maven-install-plugin ; install 将 项 目 输出 构件 安装 到 本 地 仓库 
deploy maven-deploy-plugin :deploy 将 项 目 输出 构件 部 署 到 远程 仓库 


注意 ， 表 7-3 只 列 出 了 拥有 插件 绑 定 关系 的 阶段 ，default 生 命 周期 
还 有 很 多 其 他 阶段 ， 默 认 它 们 没有 绑 定 任何 插件 ， 因 此 也 没有 任何 实 


除了 默认 的 打包 类 型 jar 之 外 ， 篆 见 的 打包 类 型 还 有 war、pom、 
maven-plugin 、ear 等 。 它 们 的 default 生 命 周 期 与 插件 目标 的 绑 定 关系 可 
参阅 Maven 官 方 文档 : 
http://maven.apache.org/guides/introduction/introduction-to-the- 


lifecycle.html#Built-in_Lifecycle_Bindings, 1x EPH 。 


读者 可 以 从 Maven 的 命令 行 输出 中 看 到 在 项 目 构 建 过 程 执 行 了 哪些 
插件 目标 ， 例 如 基于 account-email 执 行 mvn clean install 命 令 ， 可 以 看 到 
如 下 输出 ， 见 代码 清单 7-2。 


代码 清单 7-2 ”Maven 输 出 中 包含 了 生命 周期 阶段 与 播 件 的 绑 定 关 
R 


[INFO] 

[INFO] -—-- maven-clean-plugin:2.3:clean (default-clean) @ account-email --- 

[INFO] Deleting file set: D: \git—-juven \maven-book \code \ch-5 \account-email \tar- 
get... 


[INFO] --- maven-resources-plugin:2.4,1:resources (default-resources) @ ac- 
count-email --- 
[INFO] Using 'UTF-8'encoding to copy filtered resources. 


[INFO] --- maven-compiler-plugin:2.0.2:compile (default-compile) @ account- 
email 一 -一 
[INFO] Compiling 3 source files to D: \git-—juven \maven-book \code \... 


[INFO] --- maven-resources-plugin:2.4.1:testResources (default-testResources) 
@ account-email --- 


[INFO] Using 'UTF-8'encoding to copy filtered resources. 

[INFO] -—-- maven-compiler-plugin:2.0.2:testCompile (default-testCompile) @ ac- 
count-email --- 

[INFO] Compiling 1 source file to... 


[INFO] --- maven-surefire-plugin:2.4.3:test (default-test) @ account-email -- 
[INFO] Surefire report directory: D: \git-juven \maven-book \code \... 


[INFO] --- maven-jar-plugin:2.2:jar (default-jar) @ account-email --- 
[INFO] Building jar: D: \git-juven \maven-book \ code \.... 


[INFO] --- maven-install-plugin:2.3:install (default-install) @ account-email 
NFO] Installing D: \git-juven \maven-book \code \... 


LENEQ] 3 tier sitterm nati tare eet a 
[INFO] BUILD SUCCESS 
KAES ee ee a 


从 输出 中 可 以 看 到 ， 执 行 的 插件 目标 依次 为 maven-clean-plugin: 
clean ` maven-resources-plugin: resources ` maven-compiler-plugin: 
compile ` maven-resources-plugin: testResources ` maven-compiler- 


plugin: testCompile ` maven-surefire-plugin: test ~ maven-jar-plugin: jar 


Allmaven-install-plugin: install。 我 们 知道 ，mvn clean install 命 令 实际 调 
用 了 clean 生 命 周 期 的 pre-clean 、clean 阶 段 ， 以 及 default 生 命 周 期 的 从 
validate 至 install 所 有 阶段 。 在 此 基础 上 ， 通 过 对 照 表 7-1 和 表 7-3， 丈 能 
从 理论 上 得 到 将 会 执行 的 插件 目标 任务 ， 而 实际 的 输出 完全 验证 了 这 
Bo 


74.2 AeA 


除了 和 内置 绑 定 以 外 ， 用 户 还 能 够 目 己 选择 将 某 个 插件 目标 绑 定 到 
生命 周期 的 某 个 阶段 上 ， 这 种 自 定义 绑 定 方式 能 让 Maven 项 目 在 构建 过 
程 中 执行 更 多 更 富 特 色 的 任务 。 

一 个 稼 见 的 例子 是 创建 项 目的 源码 jar 包 ， 内 置 的 插件 绑 定 关系 中 


并 没有 涉及 这 一 任务 ， 因 此 需要 用 户 上 自行 配置 。maven-source-plugin 可 
以 帮助 我 们 完成 该 任务 ， 它 的 jar-no-fork 目 标 能 够 将 项 目的 主 代 码 打 包 


成 jar 文 件 ， 可 以 将 其 绑 定 到 default 生 命 周期 的 verify 阶 段 上 ， 在 执行 完 
集成 测试 后 和 安装 构件 之 前 创建 源码 jar 包 。 具 体 配 置 见 代码 清单 7-3。 


代码 清单 7-3” 目 定义 绑 定 插件 目标 


build > 
<plugir 
<plugi 
yroupId rg ache. maven. plugins < /groupid > 
<artifactId >maven-source-plugin < /artifactId > 
jersi = 2 ae age l ersi > 
exe ions > 
xecution 
id >attach-sources 
phase erify phase 
oal 
<g L > jar-no-for J ] 
< / goal 
< /executio 
< /executic 
< /plugin 
< /plugins 
build > 


在 POM 的 build 元 素 下 的 plugins 子 元 素 中 声明 插件 的 使 用 ， 该 例 中 
用 到 的 是 maven-source-plugin， 其 groupId 为 org.apache.maven.plugins， 
这 也 是 Maven 官 方 插件 的 groupId， 紧 接着 artifactId 为 maven-source- 
plugin，version 为 2.1.1。 对 于 自 定 义 绑 定 的 插件 ， 用 户 总 是 应 该 声明 一 
个 非 快照 版 本 ， 这 样 可 以 避免 由 于 插件 版 本 变化 造成 的 构建 不 稳定 
性 。 


上 述 配 置 中 ， 除 了 基本 的 插件 坐标 声明 外 ， 还 有 插件 执行 配置 ， 
executions 下 每 个 execution 子 元 素 可 以 用 来 配置 执行 一 个 任务 。 该 例 中 
配置 了 一 个 id 为 attach-sources 的 任务 ， 通 过 phrase 配 置 ， 将 其 绑 定 到 
verify 生 命 周 期 阶段 上 ， 再 通过 goals 配 置 指定 要 执行 的 插件 目标 。 至 
此 ， 目 定义 插件 绑 定 完成 。 运 行 mvn verify 束 能 看 到 如 下 输出 : 


[INFO] --- maven-source-plugin:2.1.1:jar-no-fork (attach-sources) @ my-proj -— 


y OurC 
[INFO] Building jar: D: \code\ch-7 \tarcget \my-proj-0.0.1-SNAPSHOT-sources. jar 


我 们 可 以 看 到 ， 当 执行 verify 生 命 周期 阶段 的 时 候 ，maven-source- 
plugin: jar-no-fork 会 得 以 执行 ， 它 会 创建 一 个 以 -sources.jar 结 尾 的 源码 
文件 包 。 


有 时 候 ， 即 使 不 通过 phase 元 素 配置 生命 周期 阶段 ， 插 件 目 标 也 能 
够 绑 定 到 生命 周期 中 去 。 例 如 ， 可 以 稚 试 删除 上 述 配 置 中 的 phase 一 
行 ， 再 次 执行 mvn verify， 仍 然 可 以 看 到 maven-source-plugin: jar-no- 
fork 得 以 执行 。 出 现 这 种 现象 的 原因 是 : 有 很 多 插件 的 目标 在 编写 时 已 


经 定义 了 默认 弧 定 阶段 。 可 以 使 用 maven-help-plugin 查 看 插件 详细 信 
轧 ， 了 解 插件 目标 的 默认 绑 定 阶段 。 运 行 命令 如 下 : 


$ mvn help: describe-Dplugin = org.apache.maven.plugins:maven- source-plugin: 


2.1.1-Ddetail 


aw 


该 命令 输出 对 应 插件 的 详细 信息 。 在 输出 信息 中 ， 能 够 看 到 关于 


aw 


目标 jar-no-fork 的 如 下 信息 : 


source:jar-no-fork 
Description: This goal bundles all the sources into z 
goal functions the same as the jar goal but does not 
suitable for attaching to the build lifecycle. 


Deprecated. No reason given 
Implementation: org. apache, maven. plugin. source. SourceJarNoForkMojo 


Language: java 


Bound to phase: package 


Available parameters: 


该 输出 包含 了 一 段 关 于 jar-no-fork 目 标的 描述 ， 这 里 关心 的 是 
Bound to phase 这 一 项 ， 它 表示 该 目标 默认 绑 定 的 生命 周期 阶段 (这 里 
是 package) 。 也 就 是 说 ， 当 用 户 配置 使 用 maven-source-plugin 的 jar-no- 
fork A pre, WOR ATEEphaseBAN, 1% A PA UAE Fllpackage 
阶段 。 

我 们 知道 ， 当 插件 目标 被 绑 定 到 不 同 鸭 生命 周期 阶段 的 时 候 ， 其 


执行 顺序 会 由 生命 周期 阶段 的 移 后 顺序 决定 。 如 果 多 个 目标 被 绑 定 到 
同一 个 阶段 ， 它 们 的 执行 顺序 会 是 怎样 ? 答案 很 简单 ， 当 多 个 插件 目 


标 绑 定 到 同一 个 阶段 的 时 候 ， 这 些 插件 声明 的 先后 顺序 决定 了 目标 的 
执行 顺序 ° 


7.5 插件 配置 


完成 了 插件 和 生命 周期 的 绑 定 之 后 ， 用 户 还 可 以 配置 插件 目标 的 
参数 ， 进 一 步调 整 插 件 目标 所 执行 的 任务 ， 以 满足 项 目的 需求 。 几 乎 
所 有 Maven 插 件 的 目标 都 有 一 些 可 配置 的 参数 ， 用 户 可 以 通过 命令 行 
和 POM 配 置 等 方式 来 配置 这 些 参数 。 


7.5.1 命令 行 插件 配置 


在 日 常 的 Maven 使 用 中 ， 我 们 会 经 第 从 命令 行 输入 并 执行 Maven 
命令 。 在 这 种 情况 下 ， 如 果 能 够 方便 地 更 改 某 些 插件 的 行为 ， 无 疑 会 
十 分 方便 。 很 多 插件 目标 的 参数 都 文 择 从 命令 行 配置 ， 用 户 可 以 在 
Maven 命 令 中 使 用 -D 参 数 ， 并 伴随 一 个 参数 键 = 参数 值 的 形式 ， 来 配置 
插件 目标 的 参数 。 


例如 ，maven-surefire-plugin 提 供 了 一 个 maven.test.skip 参 数 ， 当 其 
值 为 true 的 时 候 ， 就 会 跳 过 执行 测试 。 于 是 ， 在 运行 命令 的 上 时候， 加 
上 如 下 -D 参 数 束 能 跳 过 测试 : 


$ mvn install-Dmaven. test. skip =true 


参数 -D 是 Java 目 带 的 ， 其 功能 是 通过 命令 行 设置 一 个 Java 系 统 属 
性 ，Maven 简 单 地 重用 了 该 参数 ， 在 准备 插件 的 时 候 检 查 系 统 属 性 ， 
便 实现 了 插件 参数 的 配置 。 


7.5.2”POM 中 插件 全 局 配置 


并 不 是 所 有 的 插件 参数 都 适合 从 命令 行 配置 ， 有 些 参数 的 值 从 项 
目 创建 到 项 目 发 布 都 不 会 改变 ， 或 者 说 很 少 改 变 ， 对 于 这 种 情况 ， 在 
POM 文 件 中 一 次 性 配置 束 显 然 比 重复 在 命令 行 输入 要 方便 。 


用 户 可 以 在 声明 插件 的 时 候 ， 对 此 插件 进行 一 个 全 局 的 配置 。 也 
就 是 说 ， 所 有 该 基于 该 插件 目标 的 任务 ， 都 会 使 用 这 些 配置 。 例 如 ， 
我 们 通常 会 需要 配置 maven-compilerplugin 告 诉 它 编译 Java 1.5 版 本 的 源 
文件 ， 生 成 与 JVM 1.5 兼 容 的 字 忆 码 文件 ， 见 代码 清单 7-4。 


代码 清单 7-4 在 POM 中 对 插件 进行 全 局 配置 


< GroupIG >org. apache. maven. plugins < /groupId > 
<artifactId >maven-compiler-plugin < /artifactId> 
<version >2.1</version> 
< CO uration 
<£ rce>1.5 irce 
<target >1. x 
< /configuratior 
/plug 
plug 


这 样 ， 不 管 绑 定 到 compile 阶 段 的 maven-compiler-plugin: compile 任 
务 ， 还 是 绑 定 到 test-compiler 阶 段 的 maven-compiler-plugin: testCompiler 


任务 ， 束 都 能 够 使 用 该 配置 ， 基 于 Java 1.5 版 本 进行 编译 。 


7.5.3 ” POM 中 插件 任务 配置 


除了 为 插件 配置 全 局 的 参数 ， 用 户 还 可 以 为 某 个 插件 任务 配置 特 
定 的 参数 。 以 maven-antrun-plugin 为 例 ， 它 有 一 个 目标 run， 可 以 用 来 在 
Maven 中 调用 Ant 任 务 。 用 户 将 maven-antrun-plugin: run 绑 定 到 多 个 生 
命 周 期 阶段 上 ， 再 加 以 不 同 的 配置 ， 就 可 以 让 Maven 在 不 同 的 生命 阶段 
执行 不 同 的 任务 ， 见 代码 清单 7-5。 


代码 清单 7-5 ”在 POM 中 对 插件 进行 任务 配置 


<build> 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-antrun-plugin < /artifactId > 
<version >1.3 < /version > 
<executions > 


<execution > 


<id>ant-validate < Ia > 
<phase >validate < / Phase > 


<cgoals > 

<goal >run < /goal > 
< /goals > 
< configuration > 


<tasks > 


< o >I'm bound to validate phase. < /echo > 
</tasks > 
< /configuration > 
< /execution > 
<execution > 
<id>ant-verify </id> 
<phase >verify < /phase > 
<goals > 
<goal >run < /goal > 
< /goals > 
< configuration > 
<tasks > 


在 上 述 代 码 片段 中 ， 首 先 ，maven-antrun-plugin: run 与 validate 阶 
段 绑 定 ， 从 而 构成 一 个 id 为 ant-validate 的 任务 。 插 件 全 局 配置 中 的 
configuration 元 素 位 于 plugin 元 素 下 面 ， 而 这 里 的 configuration 元 素 则 位 
于 execution 元 素 下 ， 表 示 这 是 特定 任务 的 配置 ， 而 非 插 件 整体 的 配 
置 。 这 个 ant-validate 任 务 配置 了 一 个 echo Ant 任 务 ， 向 命令 行 输出 一 段 
文字 ， 表 示 该 任务 是 绑 定 到 validate 阶 段 的 。 第 二 个 任务 的 id 为 ant- 
verify， 它 绑 定 到 了 verify 阶 段 ， 同 样 它 也 输出 一 段 文 字 到 命令 行 ， 告 诉 


该 任务 绑 定 到 了 verify 阶 段 。 


7.6 获取 插件 信息 


仅仅 理解 如 何 配置 使 用 插件 是 不 够 的 。 当 遇 到 一 个 构建 任务 的 时 
候 ， 用 户 还 需要 知道 去 哪里 寻找 合适 的 插件 ， 以 帮助 完成 任务 。 找 到 
正确 的 插件 之 后 ， 还 要 详细 了 解 该 插件 的 配置 点 。 由 于 Maven 的 插件 
非常 多 ， 而 且 这 其 中 的 大 部 分 没有 完善 的 文档 ， 因 此 ， 使 用 正确 的 插 
件 并 进行 正确 的 配置 ， 其 实 并 不 是 一 件 容 易 的 事 。 


7.6.1 ”在 线 插件 信息 


基本 上 所 有 主要 的 Maven 插 件 都 来 目 Apache 和 Codehaus。 由 于 
Maven 本 刁 是 属于 Apache 软 件 基金 会 的 ， 因 此 它 有 很 多 官方 的 插件 ， 
天 都 有 成 千 上 万 的 Maven 用 户 在 使 用 这 些 择 件 ， 它 们 具有 非常 好 的 稳定 
性 。 庄 细 的 列表 可 以 在 这 个 地 址 得 到 |: 
http://maven.apache.org/plugins/index.html， 单 击 某 个 插件 的 链接 便 可 以 
得 到 进一步 的 信息 。 所 有 官方 插件 能 在 这 里 下 载 : 


http://repo1.maven.org/maven2/org/apache/maven/plugins/ ° 


除了 Apache 上 的 官方 插件 之 外 ， 托 管 于 Codehaus 上 的 Mojo 项 目 也 
提供 了 大 量 了 Maven 插 件 ， 详 细 的 列表 可 以 访问 : 
http://mojo.codehaus.org/plugins.html。 需 要 注意 的 是 ， 这 些 插件 的 文档 
和 可 靠 性 相对 较 差 ， 在 使 用 时 ， 如 果 遇 到 问题 ， 能 自己 去 看 源 
代码 。 所 有 Codehaus 的 Maven 插 件 能 在 这 里 下 载 : 


http://repository.codehaus.org/org/codehaus/mojo/ ° 


由 于 上 述 两 个 冰点 提供 的 插件 非常 多 ， 而 实际 使 用 中 常用 的 插件 
是 这 个 数量 ， 因 此 附录 C 归 纳 了 一 些 比较 常用 的 插件 。 


(Si 
人 


虽然 并 非 所 有 插件 都 提供 了 完善 的 文档 ， 但 一 些 核 心 插件 的 文档 
还 是 非常 丰富 的 。 以 maven-surefire-plugin 为 例 ， 访 问 


http://maven.apache.org/plugins/maven-surefire-plugin/ 可 以 看 到 该 插件 的 
简要 介绍 、 包 含 的 目标 、 使 用 介绍 、FAQ 以 及 很 多 实例 ， 如 图 7-3 所 


?Overview Maven Surefire Plugin 
Introduction 
tiie The Surefire Plugin is used during the test phase of the build lifecycle to execute the unit 
FA F 
Q es Plain text files (*.txt) 
ee ae s XML files (*.xml) 


Using TestNG 

Skipping Tests 
Inclusions and Exclusions £ n 

of Tests For an HTML format of the report, please see the Maven Surefire Report Plugin @. 
Running a Single Test 

Class Loading Issues 

Debugging Tests 

System Properties Goals Overview 

Additional Classpath 

Elements 


By default, these files are generated at ${basedir}/target/surefire-reports. 


The Surefire Plugin has only 1 goal: 


Project Documentation š 
= e surefire:test runs the unit tests of an application. 
v Project Information 
About 
Continuous 
Integration 
Dependencies 
Dependency 


Convergence General instructions on how to use the Surefire Plugin can be found on the usage page. 
app examples, tips or errata to the plugin's wiki page @. 


clUsage 


图 7-3 ”maven-surefire-plugin 的 文档 页 面 


一 般 来 说 ， 通 过 阅读 插件 文档 中 的 使 用 介绍 和 实例 ， 融 应 该 能 够 
在 自己 的 项 目 中 很 好 地 使 用 该 插件 。 但 当 我 们 想 了 解 非常 细节 的 目标 
参数 时 ， 就 需要 进一步 访问 该 插件 每 个 目标 的 文档 。 以 maven-surefire- 
plugin 为 例 〈 见 第 7.5.1 节 ) ， 可 以 通过 在 命令 行 传 入 maven.test.skip 人 参数 
来 跳 过 测试 执行 ， 而 执行 测试 的 插件 目标 是 surefire: test， 访 问 其 文 
档 : http://maven.apache.org/plugins/maven-surefire-plugin/test- 


mojo.html， 可 以 找到 目标 参数 skip， 如 图 7-4 所 示 。 


m, 
mtaa ae? 


Set this to 'true’ to bypass unit tests entirely. Its use is NOT RECOMMENDED, especially if 
you enable it using the "maven.test.skip" property, because maven.test.skip disables both 
running the tests and compiling the tests. Consider using the skipTests parameter instead. 


e Type: boolean 
* Required: Ho 
+ Expression: ${maven. test. skip} 


图 7-4 maven-surefire-plugin: test 的 Skip 参数 


文档 详细 解释 了 该 参数 的 作用 、 类 型 等 信息 。 基 于 该 信息 ， 用 户 
可 以 在 POM 中 配置 maven-surefire-plugin 的 Skip 参数 为 true 来 跳 过 测试 。 
这 个 时 候 读 者 可 能 会 不 理解 了 ， 之 前 在 命令 行 传 入 的 参数 不 是 
maven.test.skip 吗 ? 的 确 如 此 ， 虽 然 对 于 该 插件 目标 的 作用 是 一 样 的 ， 
但 从 命令 行 传 入 的 参数 确实 不 同 于 该 插件 目标 的 参数 名 称 。 命 令 行 参 
数 是 由 该 插件 参数 的 表达 式 (Expression) 决定 的 。 从 图 7-4 中 能 够 看 
到 ，surefire: test skip 参 数 的 表达 式 为 $6 {maven.test.skip}， 它 表示 可 以 
在 命令 行 以 -Dmaven.test.skip=true 的 方式 配置 该 目标 。 并 不 是 所 有 插件 
目标 参数 都 有 表达 式 ， 也 就 是 说 ， 一 些 插件 目标 参数 只 能 在 POM 中 配 
oo 


7.6.2 ”使 用 maven-help-plugin 摘 述 插 件 


除了 访问 在 线 的 插件 文档 之 外 ， 还 可 以 借助 maven-help-plugin 来 获 
取 插 件 的 详细 信息 。 可 以 运行 如 下 命令 来 获取 maven-compiler-plugin 
2.1 版 本 的 信息 : 


$ mn help: describeDplugin = org.apache.maven.plugins: maven-compiler- 
plugin:2.1 


这 里 执行 的 是 maven-help-plugin 的 describe 目 标 ， 在 参数 plugin 中 输 
入 需要 描述 插件 的 groupId、artifactId 和 version。Maven 在 命令 行 输 出 
maven-compiler-plugin 的 简要 信息 ， 包 括 该 插件 的 坐标 、 目 标 前 级 和 目 
标 等 ， 见 代码 清单 7-6。 


代码 清单 7-6 ”使 用 maven-help-plugin 获 取 插 件 信 息 


Name: Maven Compiler Plugin 

Description: The Compiler Plugin is used to compile the sources of your 
project. 

Group Id: org. apache. maven. plugins 

Artifact Id: maven-compiler-plugin 

Version: 2.1 

Goal Prefix: compiler 


This plugin has 3 goals: 


compiler:compile 
Description: Compiles application sources 


compiler :help 
Description: Display help information on maven-compiler-plugin. 
mvn compiler :help-Ddetail = true-Dgoal = <goal-name > 
to display parameter details. 


compiler :testCompile 
Description: Compiles application test sources. 


or more information, run’mvn help:describe [...]-Ddetail' 


对 于 坐标 和 插件 目标 ， 不 再 多 做 解释 ， 这 里 值得 一 提 的 是 目标 前 
级 (Goal Prefix) ， 其 作用 是 方便 在 命令 行 直 接 运 行 插 件 。 在 第 7.8 节 
会 做 进一步 解释 。maven-compiler-plugin 的 目标 前 级 是 compiler ° 


在 描述 插件 的 时 候 ， 还 可 以 省 去 版 本 信息 ， 让 Maven 目 动 获取 最 新 
版 本 来 进行 表述 。 例 如 ; 


$ mvn help:describe-Dplugin =org. apache. maven. plugins :maven-compiler-plugin 


aie, BY DE TAP H po ree ho HAT: 


$ mvn help:describe-Dplugin = compiler 


如 有 果 想 仅仅 描述 某 个 插件 目标 的 信息 ， 可 以 加 上 goal 参 数 : 


$ mvn help:describe-Dplugin =compiler-Dgoal =compile 


如 有 果 想 让 maven-help-plugin 和 输出 更 详细 的 信息 ， 可 以 加 上 detail 参 
数 : 


s mvn help:describe-Dplugin = compiler-Ddetail 


读者 可 以 在 实际 环境 中 使 用 help: describe 描 述 一 些 常用 插件 的 信 
息 ， 以 得 到 更 加 直观 的 感受 。 


7.7 ”从 命令 行 调用 插件 


如 果 在 命令 行 运行 mvn-h 来 显示 mvn 命 令 帮助 ， 就 可 以 看 到 如 下 的 


Options: 


该 信息 告诉 了 我 们 mvn 命 令 的 基本 用 法 ，options 表 示 可 用 的 选项 ， 
mvn 命 令 有 20 多 个 选项 ， 这 里 暂 不 详 述 ， 读 者 可 以 根据 说 明 来 了 解 每 个 
选项 的 作用 。 除 了 选项 之 外 ，mvn 命 令 后 面 可 以 添加 一 个 或 者 多 个 goal 
和 phase， 它 们 分 别 是 指 插件 目标 和 生命 周期 阶段 。 第 7.2.5 市 已 经 详细 
介绍 了 如 何 通 过 该 参数 控制 Maven 的 生命 周期 。 现 在 我 们 关心 的 是 男 外 


一 个 参数 : goal ° 


我 们 知道 ， 可 以 通过 mvn 命 令 激 活 生 命 周期 阶段 ， 从 而 执行 那些 绑 
定 在 生命 周期 阶段 上 的 插件 目标 。 但 Maven 还 文 持 直接 从 命令 行 调用 插 
件 目标 。Maven 文 持 这 种 方式 是 因为 有 些 任务 不 适合 绑 定 在 生命 周期 
上 ， 例 如 maven-help-plugin: describe， 我 们 不 需要 在 构建 项 目的 时 候 
去 描述 插件 信息 ， 又 如 maven-dependency-plugin: tree， 我 们 也 不 需要 
在 构建 项 目的 时 候 去 显示 依赖 树 。 因 此 这 些 插件 目标 应 该 通过 如 下 方 
起 使 用 ， 


不 过 ， 这 里 还 有 一 个 疑问 ，describe 是 maven-help-plugin 的 目标 没 
销 ， 但 冒号 前 面 的 heljp 是 什么 呢 ? 它 既 不 是 groupId， 也 不 是 artifactId ， 
Maven 是 如 何 根据 该 信息 找到 对 应 版 本 插件 的 呢 ? 同 理 ， 为 什么 不 是 


maven-dependency-plugin: tree， 而 是 dependency: tree’? 


解答 该 疑问 之 前 ， 可 以 先 笑 试 一 下 如 下 的 命令 : 


$ mvn org.apache.maven.plugins :maven-—-help-plugin:2,1 :describe-Dplugin =compi le 


$ mvn org.apache.maven.plugins:maven-dependency-plugin:2.1 :tree 


这 两 条 命令 束 比 较 容 易 理解 了 ， 揪 件 的 groupId ` artifactId ` version 
以 及 goal 都 得 以 清晰 描述 。 它 们 的 效果 与 之 前 的 两 条 命令 基本 是 一 样 
的 ， 但 显然 前 面 的 命令 更 向 洛 ， 更 容易 记忆 和 使 用 。 为 了 达到 该 目 
的 ，Maven 引 入 了 目标 前 级 的 概念 ，help 是 maven-help-plugin 的 目标 前 
级 ，dependency 是 maven-dependency-plugin 的 前 级 ， 有 了 插件 前 级 ， 
Maven 就 能 找到 对 应 的 artifactId。 不 过 ， 除 了 artifactId4，Maven 还 需要 得 
到 groupId 和 version 才 能 精确 定位 到 某 个 插件 。 下 一 忆 将 详细 解释 这 个 
过 程 。 


7.8 插件 解析 机 制 


为 了 方便 用 户 使 用 和 配置 插件 ，Maven 不 需要 用 户 提供 完整 的 插 
件 坐 标 信息 ， 吏 可 以 解析 得 到 正确 的 插件 ，Maven 的 这 一 特性 是 一 把 
双 刃 剑 ， 虽 然 它 稍 化 了 插件 的 使 用 和 配置 ， 可 一 旦 插件 的 行为 出 现 异 
常 ， 用 户 束 很 难 快 速 定 位 到 出 问题 的 插件 构件 。 例 如 mvn help: system 
这 样 一 条 命 仿 ， 它 到 发 执行 了 什么 插件 ?该 插件 的 groupId ` artifactId 
和 version 分 别 是 什么 ? 这 个 构件 是 从 哪里 来 的 ? 本 市 束 详 细 介 绍 
Maven 的 运行 机 制 ， 以 让 读者 不 仅 知 其 然 ， 更 知 其 所 以 然 。 


7.8.1 ”插件 仓库 


与 依赖 构件 一 样 ， 插 件 构 件 同样 基于 坐标 存储 在 Maven 仓 库 中 。 在 
需要 的 时 候 ，Maven 会 从 本 地 仓库 寻找 插件 ， 如 有 果 不 存在 ， 则 从 远程 仓 
库 碍 找 。 找 到 插件 之 后 ， 再 下 载 到 本 地 仓库 使 用 。 


值得 一 提 的 是 ，Maven 会 区 别 对 待 依赖 的 远程 仓库 与 插件 的 远程 仓 
库 ， 第 6.4 广 介绍 了 如 何 配 置 远程 仓库 ， 但 那 种 配置 只 对 一 般 依赖 有 效 
果 。 当 Maven 需 要 的 依赖 在 本 地 仓库 不 存在 时 ， 它 会 去 所 配置 的 远程 仓 
库 查 找 ， 可 是 当 Maven 需 要 的 插件 在 本 地 仓库 不 存在 时 ， 它 就 不 会 去 这 
些 远 程 仓库 查找 。 


不 同 于 repositories 及 其 repository 子 元 素 ， 插 件 的 远程 仓库 使 用 
pluginRepositories 和 pluginRepository 配 置 。 例 如 ，Maven 内 置 了 如 下 的 
插件 远程 仓库 配置 ， 见 代码 清单 7-7。 


代码 清单 7-7 Maven 内 置 的 插件 仓库 配置 


除了 pluginRepositories 和 pluginRepository 标 签 不 同 之 外 ， 其 余 所 有 
子 元 素 表 达 的 含义 与 第 6.4 下 所 介绍 的 依赖 远程 仓库 配置 完全 一 样 。 我 
们 甚至 看 到 ， 这 个 默认 插件 仓库 的 地 址 就 是 中 央 仓 库 ， 它 关闭 了 对 
SNAPSHOT 的 支持 ， 以 防止 引入 SNAPSHOT 版 本 的 插件 而 导致 不 稳定 
的 构建 。 


一 般 来 说 ， 中 央 仓 库 所 包含 的 插件 完全 能 够 满足 我 们 的 需要 ， 
此 也 不 需要 配置 其 他 的 插件 仓库 。 只 有 在 很 少 的 情况 下 ， 项 目 使 用 的 
插件 无 法 在 中 央 仓 库 找 到 ， 或 者 目 己 编写 了 插件 ， 这 个 时 候 可 以 参考 
上 述 的 配置 ， 在 POM 或 者 settings.xml 中 加 入 其 他 的 插件 仓库 配置 。 


7.8.2 ”插件 的 默认 groupId 


在 POM 中 配置 插件 的 时 候 ， 如 果 该 插件 是 Maven 的 官方 插件 B 
如 果 其 groupId 为 org.apache.maven.plugins) ， 就 可 以 省 略 groupId 配 置 ， 
见 代码 清单 7-8。 


代码 清单 7-8 配置 官方 插件 和 省 略 groupId 


<build> 
<plugins > 
<plugin > 

<artifactId >maven-compiler-plugin < /artifactId> 

<version >2.1 </version> 

< configuration > 
< source >1.5 < /source > 
<target >1.5 < /target > 
‘configuration > 


</plugin > 


上 述 配 置 中 省 略 了 maven-compiler-plugin 的 groupId，Maven 在 解析 
该 插件 的 时 候 ， 会 目 动用 默认 groupId org.apache.maven.plugins¢h3t ° 


笔者 不 推荐 使 用 Maven 的 这 一 机 制 ， 虽 然 这 么 做 可 以 省 略 一 些 配 
置 ， 但 这 样 的 配置 会 让 团队 中 不 熟悉 Maven 的 成 员 感 到 费解 ， 况 且 能 省 
SAAC aK TTE ° 


7.8.3 ”解析 插件 版 本 


同样 站 为 了 们 化 插件 的 配置 和 使 用 ， 在 用 户 没有 提供 插件 版 本 的 
情况 下 ，Maven 会 日 动 解析 插件 版 本 。 


首先 ，Maven 在 超级 POM 中 为 所 有 核心 插件 设 定 了 版 本 ， 超 级 
POM 是 所 有 Maven 项 目的 父 POM， 所 有 项 目 都 继承 这 个 超级 POM 的 配 
置 ， 因 此 ， 即 使 用 户 不 加 任何 配置 ，Maven 使 用 核心 插件 的 时 候 ， 它 们 
的 版 本 就 已 经 确定 了 。 这 些 插件 包括 maven-clean-plugin、maven- 


compiler-plugin、maven-surefire-plugin 等 。 


如 果 用 户 使 用 某 个 插件 时 没有 设 定 版 本 ， 而 这 个 插件 又 不 属于 核 
心 播 件 的 范畴 ，Maven 就 会 去 检查 所 有 仓库 中 可 用 的 版 本 ， 然 后 做 出 选 
择 。 读 者 可 以 回顾 一 下 第 6.6 节 中 介绍 的 仓库 元 数据 
groupId/artifactId/maven-metadata.xml。 以 maven-compiler-plugin 为 例 ， 
它 在 中 央 仓 库 的 仓库 元 数据 为 


http://repo1.maven.org/maven2/org/apache/maven/plugins/maven-compiler- 


plugin/maven-metadata.xml， 其 内 容 见 代码 清单 7-9。 


代码 清单 7-9 maven-compilerplugin 的 groupId/artifactId 仓 库 元 数据 


etadata > 
yroupld rg.apact T n.plugi J 1 
tifactId >maven- piler-pli rtifactId 
ersioning > 
latest >2.1</late 
elease >2.1 1 
versions > 
< version > sior 
Ve on >z 
VE on >z 
ver ns > 
lastUpdated 1 < /lastUpdated > 
rs Lng > 
metadat 


Maven j A Ht OE APRA RET TE Oe, RARE PAY CRN 
据 归 并 后 ， 就 能 计算 出 latest 和 release 的 值 。latest 表 示 所 有 仓库 中 该 构 
件 的 最 新 版 本 ， 而 release 表 示 最 新 的 非 快照 版 本 。 在 Maven 2 中 ， 插 件 
的 版 本 会 被 解析 至 latest。 也 束 是 说 ， 当 用 户 使 用 某 个 非 核心 插件 且 没 
有 声明 版 本 的 时 候 ，Maven 会 将 版 本 解析 为 所 有 可 用 仓库 中 的 最 新 版 
本 ， 而 这 个 版 本 也 可 能 是 快照 版 。 


当 搬 件 的 版 本 为 快照 版 本 时 ， 束 会 出 现 潜在 的 问题 。Maven 会 基于 
更 新 策略 ， 检 查 并 使 用 快照 的 更 新 。 某 个 插件 可 能 昨天 还 用 得 好 好 
的 ,今天 整 出 错 了 ， 其 原因 就是 这 个 快照 版 本 的 插件 发 生 了 变化 。 为 
了 防止 这 类 问题 ，Maven 3 调整 了 解析 机 制 ， 当 插件 没有 声明 版 本 的 时 
候 ， 不 再 解析 至 latest， 而 是 使 用 release。 这 样 就 可 以 避免 由 于 快照 频繁 
更 新 而 导致 的 插件 行为 不 稳定 。 


依赖 Maven 解 析 揪 件 版 本 其 实 是 不 推荐 的 做 法 ， 即 使 Maven 3 将 版 
本 解析 到 最 新 的 非 快照 版 ， 也 还 是 会 有 淤 在 的 不 稳定 性 。 例 如 ， 可 能 
某 个 插件 发 布 了 一 个 新 的 版 本 ， 而 这 个 版 本 的 行为 与 之 前 的 版 本 发 生 
了 变化 ， 这 种 变化 就 可 能 导致 项 目 构建 失败 。 因 此 ， 使 用 插件 的 时 
候 ， 应 该 一 直 显 式 地 设 定 版 本 ， 这 也 解释 了 Maven 为 什么 要 在 超级 
POM 中 为 核心 插件 设 定 版 本 。 


7.8.4 fear tee BIAS 
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释 Maven 如 何 根 据 插件 前 缀 解析 得 到 插件 的 坐标 。 


插件 前 级 与 groupId: artifactId 是 一 一 对 应 的 ， 这 种 匹配 关系 存储 在 
仓库 元 数据 中 。 与 之 前 提 到 的 groupId/artifactId/maven-metadata.xml 不 
同 ， 这 里 的 仓库 元 数据 为 groupId/maven-metadata.xml， 那 么 这 里 的 
groupId 是 什么 呢 ? 第 7.6.1 节 提 到 主要 的 插件 都 位 于 
http:/repol.maven.org/maven2/org/apache/maven/plugins/ 和 
http:/repository.codehaus.org/org/codehaus/mojo/， 相 应 地 ，Maven 在 解 
析 揪 件 仓库 元 数据 的 时 候 ， 会 默认 使 用 org.apache.maven.plugins 和 
org.codehaus.mojo 两 个 groupId。 也 可 以 通过 配置 settings.xml 让 Maven 检 
查 其 他 groupId 上 的 插件 仓库 元 数据 : 


<settings > 


<pluginGroups > 


<pluginGroup >com. your. plugins < /pluginGroup > 
< /pluginGroups > 
< / settings > 


基于 该 配置 ，Maven 束 不 仅仅 会 检查 


org/apache/maven/plugins/maven-metadata.xml 和 | 


org/codehaus/mojo/maven-metadata.xml, JASE 


com/your/plugins/maven-metadata.xml ° 
下 面 看 一 下 插件 仓库 元 数据 的 内 容 ， 见 代码 清单 7-10。 


代码 清单 7-10 ”插件 仓库 元 数据 


<metadata > 
<plugins > 


<plugin > 


< fartifactId> 


faven Compiler Plugin < /name > 
<prefix >compiler < /prefix> 


<artifactid >maven-compiler-plugin < /artifactId> 


<plugin> 


<name >Maven Dependency Plugin < /name > 


<prefix >dependency < 


/prefix> 
<artifactIid >maven-dependency-plugin < /artifactId > 
</plugin> 
</plugins> 


< /metadata > 


上 述 内 容 是 从 中 央 仓 库 的 org.apache.maven.plugins groupId 下 插件 仓 
库 元 数据 中 截取 的 一 些 厂 段 ， 从 这 上段 数据 中 束 能 看 到 maven-clean- 
plugin 的 前 级 为 dean，maven-compiler-plugin 的 前 级 为 compiler，maven- 


dependency-plugin 的 前 级 为 dependency。° 


当 Maven 解 析 到 dependency: tree 这 样 的 命令 后 ， 它 首先 基于 默认 
的 groupId 归 并 所 有 插件 仓库 的 元 数据 org/apache/maven/plugins/maven- 


metadata.xml; 其 次 检查 归并 后 的 元 数据 ， 找 到 对 应 的 artifactId 为 
maven-dependency-plugin; 然后 结合 当前 元 数据 的 groupId 
org.apache.maven.plugins; 最 后 使 用 第 7.8.3 世 摘 述 的 方法 解析 得 到 
version， 这 时 就 得 到 了 完整 的 插件 坐标 。 如 采 
org/apache/maven/plugins/maven-metadata.xml 没 有 记录 该 插件 前 级 ， 则 
接着 检查 其 他 groupId 下 的 元 数据 ， 如 org/codehaus/mojo/maven- 
metadata.xml， 以 及 用 户 目 定 义 的 插件 组 。 如 采 所 有 元 数据 中 都 不 包含 
该 前 绥 ， 则 报错 。 


79 放生 


本 章 介 绍 了 Maven 的 生命 周期 和 插件 这 两 个 重要 的 概念 。 不 仅 解 
释 了 生命 周期 背后 的 理念 ， 还 详细 阐述 了 clean、default、site 三 套 生 命 
周期 各 目的 内 容 。 此 外 ， 本 章 还 重点 介绍 了 Maven 插 件 如 何 与 生命 周 
期 缚 定 ， 以 及 如 何 配置 插件 行为 ， 如 何 获取 插件 信息 。 读 者 还 能 从 命 
令 行 的 视角 来 理解 生命 周期 和 插件 。 本 章 最 后 结合 仓库 元 数据 剖析 了 
Maven 内 部 的 插件 解析 机 制 ， 硕 望 能 使 得 读者 对 Maven 有 更 深刻 的 理 
解 。 


第 8 草 AAA 
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在 这 个 技术 飞速 发 展 的 时 代 ， 各 类 用 户 对 软件 的 要 求 越 来 越 高 ， 
软件 本 号 也 变 得 越 来 越 复 杀 。 因 此 ， 软 件 设 计 人 员 往 往 会 采用 各 种 方 
式 对 软件 划分 模块 ， 以 得 到 更 清晰 的 设计 及 更 高 的 重用 性 。 当 把 
Maven 应 用 到 实际 项 目 中 的 时 候 ， 也 需要 将 项 目 分 成 不 同 的 模块 ， 例 
如 ， 在 4.3.2 广 中， 本 书 的 至 景 案例 账户 注册 服务 束 补 划分 成 了 account- 
email 、account-persist 等 五 个 模块 。Maven 的 聚合 特性 能 够 把 项 目的 各 
个 模块 聚合 在 一 起 构建 ， 而 Maven 的 继承 特性 则 能 帮助 抽取 各 模块 相 


同 的 依赖 和 插件 等 配置 ， 在 简化 POM 的 同时 ， 还 能 促进 各 个 模块 配置 
的 一 致 性 。 本 章 将 结合 实际 的 案例 前 述 Maven 的 这 两 个 特性 。 


8.1 account-persist 


在 讨论 多 模块 Maven 项 目的 聚合 与 继承 之 前 ， 本 书 移 引入 账户 注 
册 服 务 的 account-persist 模 块 。 该 模块 负责 账户 数据 的 持久 化 ， 以 XML 
文件 的 形式 保存 账户 数据 ， 并 支持 账户 的 创建 、 读 取 、 更 新 、 删 除 等 
操作 。 


8.1.1 account-persistH\JPOM 


首先 ， 看 一 下 account-persist 模 块 的 POM 文 件 ， 见 代码 清单 8-1。 
代码 清单 8-1 account-persist 的 POM 


<project xmlns = "http://maven. apache.org/POM/4.0.0" 
xmlns:xsi = “http://www. w3.org/2001 /XMLSchema-instance" 

xsi:schemaLocation = "http: //maven. apache. org/POM/4.0.0 
http://maven. apache. org/maven-v4_0_0.xsd"> 

<modelVersion >4.0.0 < /modelVersion > 

<groupid >com. juvenxu.mvnbook. account < /groupid > 

<artifactId >account-persist < /artifactId> 

<name >Account Persist < /name > 

<version >1.0.0-SNAPSHOT < /version > 


< dependencies > 

< dependency > 
<groupId >dom4j < /groupiId > 
<artifactId >dom4j < /artifactId> 
<version >1.6.1</version > 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupId > 
<artifactiId >spring-core < /artifactIid > 
<version >2.5.6 < /version > 

< /dependency > 

< dependency > 
<groupId >org.springframework < /GroupIG > 
<artifactid >spring-beans < /artifactid> 
<version >2.5.6 </version > 

< /dependency > 

< dependency > 
<groupId >org.springframework < /groupId > 


<artifactId >spring-context < /artifactId > 
<version >2.5.6 </version > 
< /dependency > 
< Gependency > 
<groupld > junit < /groupid > 
<artifactId>junit < /artifactId> 
<version >4.7 < /version > 
<scope >test < /scope > 
< /dependency > 


< /dependencies > 


<build > 
<testResources > 
<testResource > 
< directory >src/test /resources < /directory > 
< filtering >true < /filtering > 
< ftestResource > 
< /testResources > 
<plugins > 
<plugin> 
<groupid >org. apache. maven. plugins < /groupIid > 
<artifactId >maven-compiler-plugin < /artifactI 


Lid > 
< configuration > 
< source >1.5< /source > 
<target >1.5 < /target > 
< /configuration > 
</plugin > 
<plugin > 
<groupid >org. apache. maven. plugins < /groupid > 
<artifactiId >maven-resources-plugin< /artifactiId > 
< configuration > 
< encoding > UTF-8 < /encoding > 


< /configuration > 


该 模块 的 坐标 为 com.juvenxu.mvnbook.account: account-persist: 
1.0.0-SNAPSHOT， 回 顾 一 下 5.3.1 节 ， 读 者 就 能 发 现 ， 该 模块 groupId 和 
version 与 account-email 模 块 完 全 一 致 ， 而 且 artifactId 也 有 相同 的 前 绥 。 
一 般 来 说 ， 一 个 项 目的 子 模块 都 应 该 使 用 同样 的 groupId， 如 果 它 们 一 
起 开发 和 发 布 ， 还 应 该 使 用 同样 的 version， 此 外 ， 它 们 的 artifactId 还 应 
该 使 用 一 致 的 前 级 ， 以 方便 同 其 他 项 目 区 分 。 


POM 中 配置 了 一 些 依赖 。 其 中 ，dom4j 是 用 来 文 持 XML 操 作 的 ; 
接 下 来 是 儿 个 springframework 的 依赖 ， 与 account-email 中 一 样 ， 它 们 主 
要 用 来 文 持 依赖 注入 ;最 后 是 一 个 测试 范围 的 junit 依 赖 ， 用 来 文 持 单 元 
测试 。 


接着 是 build 元 素 ， 它 先是 包含 了 一 个 testResources 子 元 际 ， 这 是 为 
了 开启 资源 过 滤 。 稍 后 讨论 account-persist 单 元 测试 的 时 候 ， 我 们 会 详 
细 介 绍 。 


build 元 聚 下 还 包 售 了 两 个 插件 的 配置 。 首 先是 配置 maven- 
compiler-plugin 文 持 Java 1.5， 我 们 知道 ， 虽 然 这 里 没有 配置 插件 版 本 ， 
但 由 于 maven-compiler-plugin 是 核心 插件 ， 它 的 版 本 已 经 在 超级 POM 中 
设 定 了 。 此 外 ， 如 果 这 里 不 配置 groupId，Maven 也 会 使 用 默认 的 
groupId org.apache.maven.plugins。 除 了 maven-compiler-plugin， 这 里 还 


配置 了 maven-resources-plugin 使 用 UTF-8 编 码 处 理 资 源 文件 。 


8.1.2 ”account-persist 的 主 代码 


account-persist 的 Java 主 代码 位 于 默认 的 src/main/java 目 录 ， 包 含 
Account.java ` AccountPersistService.java ` 
AccountPersistServiceImpl.java 和 AccountPersistException.java 四 个 文件 ， 
它们 的 包 名 都 是 com.juvenxu.mvnbook.account.persist， 该 包 名 与 account- 


persist 的 groupId com.juvenxu.mvnbook.account 及 artifactId account-persist 


对 应 。 


Account 类 定义 了 账户 的 简单 模型 ， 它 包含 id、name 等 字段 ， 并 为 
每 个 字段 提供 了 一 组 getter 和 setter 方 法 ， 见 代码 清单 8-2。 


代码 清单 8-2 Account.java 


package com. juvenxu.mvnbook. account. persist; 
public class Account 
{ 

private String id; 

private String name; 

private String email; 

private String password; 


private boolean activated; 


public String getId() 


{ 
return id; 
} 
public void setId{ String id ) 
{ 
this.id=id; 
} 


public String getName () 
i 
return name; 
} 
public void setName ( String name ) 
{ 
this.name =name; 


//getter and setter methods for email, password and activated 


account-persist 对 外 提供 的 服务 在 接口 AccountPersistService 中 定 
义 ， 其 方法 对 应 了 账户 的 增 、 删 、 改 、 查 ， 见 代码 清单 8-3。 


代码 清单 8-3 AccountPersistService.java 


package com. juvenxu.mvnbook. account. persist; 
public interface AccountPersistService 
Account createAccount ( Account account ) throws AccountPersistException; 
Account readAccount ( String id ) throws AccountPersistException; 
Account updateAccount ( Account account ) throws AccountPersistException; 
St 


void deleteAccount { String id ) throws AccountPersistException; 


当 增 、 删 、 改 、 查 操作 发 生 异 常 的 时 候 ， 该 服务 则 抛 出 
AccountPersistException ° 


AccountPersistService 对 应 的 实现 为 AccountPersistServiceImpl， 它 
通过 操作 XML 文 件 实 现 账户 数据 的 持久 化 。 首 先 看 一 下 该 类 的 两 个 私 
有 方法 : readDocument () 和 writeDocument () ， 见 代码 清单 8-4。 


代码 清单 8-4 ”AccountPersistServiceImpl.java 第 1 部 分 


private String file; 
private SAXReader reader =new SAXReader (); 
private Document readDocument () throws Account PersistException 
i File dataFile =new File( file ); 
if ( !dataFile.exists() ) 
i dataFile.getParentFile().mkdirs(); 
Document doc =DocumentFactory.getInstance (). createDocument (); 
Element rootEle =doc. addElement ( ELEMENT_ROOT ); 


rootEle. addElement ( ELEMENT_ACCOUNTS ); 


writeDocument ( doc ); 


try 


return reader. read( new File( file) ); 


catch ( DocumentException e ) 
{ 
throw new AccountPersistException( “Unable to read persist data xml", e); 
} 
private void writeDocument ( Document doc ) throws Account PersistException 
{ 
{ 
Writer out =null; 
try 
f 
out =new OutputStreamWriter (new FileOutputStream{ file ), "utf-8") 
XMLWriter writer =newk XMLWriter ( out, OutputFormat.createPrettyPrint () ) 
writer.write( doc ); 
catch ( IOException e ) 
throw new AccountPersistException( “Unable to write persist data xml", e); 
} 
finally 
try 
{ 
if ( out !=null) 
} 
catch ( IOExceptione ) 


throw new AccountPersistException( "Unable to close persist data xm 


writer", e); 


先 看 writeDocument () 方法 。 该 方法 首先 使 用 变量 file 构 建 一 个 文 
件 输出 流 ， 旨 e 是 AccountPersistServiceImpl 的 一 个 私有 变量 ， 它 的 值 通 
过 SpringFramework 注 入 。 得 到 输出 流 后 ， 该 方法 再 使 用 DOM4J 创 建 一 
个 XMLWriter， 这 里 的 OutputFormat.createPrettyPrint () 用 来 创建 一 个 
带 缩 进 及 换行 的 友好 格式 。 得 到 XMLWriter 后 ， 就 调用 其 write () 77 


法 ， 将 Document 写 入 到 文件 中 。 该 方法 的 其 他 代码 用 做 处 理 流 的 关闭 
BFE FE SLE o 


readDocument () 方法 与 writeDocument () 对 应 ， 它 负责 从 文件 
中 读 取 XML 数 据 ， 也 就 是 Document 对 象 。 不 过 ， 在 这 之 前 ， 该 方法 首 
先 会 检查 文件 是 否 存在 ， 如 果 不 存 在 ， 则 需要 初始 化 一 个 XML 文档 ， 
于 是 借助 DocumentFactory 创 建 一 个 Document 对 象 ， 接 着 添加 XML 元 
素 ， 再 把 这 个 不 包含 任何 账户 数据 的 XML 文档 写 入 到 文件 中 。 如 果 文 
件 已 经 被 初始 化 了 ， 则 该 方法 使 用 SAXReader 读 取 文 件 至 Document 对 
FR o 


用 来 存储 账户 数据 的 XML 文件 结构 十 分 简单 ， 如 下 是 一 个 包含 一 
个 账户 数据 的 文件 ， 见 代码 清单 8-5。 


代码 清单 8-5 ”账户 数据 的 XML 文件 


< faccount-persist > 


这 个 XML 文件 的 根 元 素 是 accountrpersist， 其 下 是 accounts 元 素 ， 


accounts 可 以 包含 零 个 或 者 多 个 account 元 素 ， 每 个 account 元 素 代 表 一 个 


账户 ， 其 子 元素 表 示 该 账户 的 id、 姓 名 、 电 子 邮 件 、 密 码 以 及 是 否 被 激 


活 等 信息 。 


现在 看 一 下 readAccount () 方法 是 如 何 从 XML 文档 读 取 并 构建 


Account 对 象 的 ， 见 代码 清单 8-6。 


public Account readAccount ( String id 


{ 


代码 清单 8-6 ” AccountPersistServiceImpl.java 第 2 部 分 


d ) throws AccountPersistException 
Document doc =readDocument (); 


Element accountsEle =doc. getRootElement (). element ( ELEMENT_ACCOUNTS ); 


for (Element accountEle : (List <Element 
4 


>) accountsEle.elements () ) 
if ( accountEle. elementText ( ELEMENT_ACCOUNT_ID ).equals( id ) ) 


return buildAccount ( accountEle ); 


return null; 


rivate Account buildAccount ( Element element ) 


Account account =new Account (); 


account. setId( element. elementText ( ELEMENT_ACCOUNT_ID ) ); 
account. setName { element. elementText ( ELEMENT_ACCOUNT_NAME ) ); 
account. setEmail ( element.elementText ( ELEMENT_ACCOUNT_EMAIL ) ) 


MG 
account. set Password ( 


element. 


account. setActivated( ( "true". equals ( element.elementText ( ELEMENT_ACCOUNT_ 


ACTIVATED ) ) ? true: false ) ); 


return account; 


readAccount () 方法 首先 获取 XML 文档 的 Document 对 象 ， 接 着 获 


取 根 元 素 的 accounts 子 元 素 ， 这 里 的 ELEMENT_ACCOUNTS 是 一 个 静 


态 常 量 ， 其 值 就 是 accounts。 接 着 遍历 accounts 的 子 元 素 ， 如 果 当 前 子 
元 素 的 id 与 要 读 取 的 账户 的 id 一 致 ， 并 且 基 于 该 子 元 素 构 建 Account 对 
象 ， 这 也 就 是 buildAccount () 方法 。 


在 buildAccount () 方法 中 ， 先 创建 一 个 Account 对 象 ， 然 后 当前 
XML 元 素 的 子 元 素 的 值 设置 该 对 象 。Element 的 elementText () 方法 能 
够 根据 子 元 到 名 称 返 回 子 元 素 的 值 ， 与 ELEMENT_ACCOUNTS 类 似 ， 
这 里 使 用 了 一 些 静 态 常 量 表示 id、name、email 等 XML 中 的 元 素 名 称 。 
Account 对 象 设置 完 后 就 直接 返回 ， 如 果 XML 文 档 中 没有 匹配 的 id， 则 
返回 null 。 


为 了 使 本 章 内 容 不 致 过 于 宛 长 ， 这 里 束 不 再 介绍 createAccount 
() 、updateAccount () 和 deleteAccount () 几 个 方法 的 实现 。 感 兴趣 
的 读者 可 以 参照 DOM4J 的 文档 实现 这 几 个 方法 ， 过 程 应 该 非常 侧 单 。 


除了 Java 人 代码，account-persist 模 块 还 需要 一 个 SpringFramework 的 
配置 文件 ， 它 位 于 src/main/resources 目 录 ， 其 内 容 见 代码 清单 8-7。 


代码 清单 8-7 ”account-persist 的 Spring 配 置 文 件 


< ?xml version ="1.0" encoding = "UTF-8"?> 
<beans xmins = "http://www. springframework. org/schema/beans" 
xmins :xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xSi:schemaLocation = “http://www. springframework. org/schema/beans 
http://www. springframework. org/schema/beans /spring-beans2.5.xsd" > 


<bean id= "propertyConfigurer" 
class = “org. springframework. beans. factory. config. PropertyPlaceholderCo- 


nfigurer" 
<property name = "location" value = "classpath :account-service. proper- 
ties > 
bean 
an id = “accoun SistService 
class = "com. juvenxu.mvnbook. account. persist. AccountPersistServicel- 
mr 


<property name = "file" value =" $ {persist.file}" 


< /bean > 


< /beans > 


该 配置 文件 首先 配置 了 一 个 id 为 propertyConfigurer 的 bean， 其 实现 
为 PropertyPlaceholderConfigurer， 作 用 是 从 项 目 classpath 载 入 名 为 
account-service.properties 的 配置 文件 。 随 后 的 bean 是 
accountPersistService， 实 现 为 AccountPersistServiceImp1， 同 时 这 里 使 用 
属性 persist.file 配 置 其 file 字 段 的 值 。 也 就 是 说 ，XML 数 据 文档 的 位 置 是 
由 项 目 classpath 下 account-service.properties 文 件 中 persist.file 属 性 的 值 配 
置 的 。 


8.1.3 ”account-persist 的 测试 代码 


定义 并 实现 了 账户 的 增 、 删 、 改 、 碍 操作 ， 当 然 也 不 能 少 了 相应 
的 测试 。 测 试 代码 位 于 src/test/java/ 目 录 下， 测试 资源 文件 位 于 
src/test/resources/ 目 录 下 。 上 一 六 SpringFramework 的 定义 要 求 项 目 
classpath 下 有 一 个 名 为 account-service.properties 的 文件 ， 并 且 该 文件 中 
需要 包含 一 个 persist.file 属 性 ， 以 定义 文件 存储 的 位 置 。 为 了 能 够 测试 
账户 数据 的 持久 化 ， 在 测试 资源 目录 下 创建 属性 文件 account- 
service.properties。 其 内 容 如 下 : 


persist.file= $ {project. build. testOutputDirectory}/persist-data. xml 


该 文件 只 包含 一 个 persist.file 属 性 ， 表 示 存 储 账户 数据 的 文件 路 
径 ， 但 是 它 的 值 并 不 是 简单 的 文件 路 径 ， 而 是 包含 了 员 
{project.build.testOutputDirectory}。 这 是 一 个 Maven 属 性 ， 这 里 读者 暂 
时 只 要 了 解 该 属性 表示 了 Maven 的 测试 输出 目录 ， 其 默认 的 地 址 为 项 目 
根 目 录 下 的 target/test-classes 文 件 夹 。 也 就 是 说， 在 测试 中 使 用 测试 输 
出 目录 下 的 persist-data.xml 文 件 存储 账户 数据 。 


现在 编写 测试 用 例 测试 AccountPersistService。 同 样 为 了 避免 宛 
余 ， 这 里 只 测试 readAccount () 方法 ， 见 代码 清单 8-8。 


代码 清单 8-8 AccountPersistServiceTest.java 


package com. juvenxu. mvnbook. account. persist; 


import static org. junit,Assert. *; 

import java.io.File; 

import org. junit. Before; 

import org. junit.Test; 

import org. springframework. context.ApplicationContext ; 

import org. springframework. context. support.ClassPathxmlApplicationContext; 


public class AccountPersistServiceTest 
{ 


private AccountPersistService service; 


@ Before 
public void prepare () 
throws Exception 
{ 
File persistDataFile =new File ( "target /test-classes/persist-data. xml"); 


if (persistDataFile.exists() ) 
{ 

persistDataFile. delete(); 
} 


ApplicationContext ctx = new ClassPathXmlApplicationContext ( "account- 
persist.xml" ); 


service = (AccountPersistService) ctx. getBean( "“accountPersistService" ); 


Account account =new Account (); 
account.setId("juven"); 

account. setName ("Juven Xu"); 

account. setEmail ("juven@ changeme.com"); 
account. setPassword ("this should be encrypted"); 
account. setActivated (true); 


service. createAccount (account); 


@ Test 
public void testReadAccount () 
throws Exception 


Account account = service. readAccount ( "juven" ); 


assertNotNull ( account ); 

assertEquals( "juven", account.getId() ); 

assertEquals( "Juven Xu", account. getName () ); 

assertEquals( "juven@ changeme. com", account. getEmail() ); 
assertEquals( "this_should_be_ encrypted", account. getPassword() ); 
assertTrue( account. isActivated() ); 


该 测试 用 例 使 用 与 AccountPersistService 一 致 的 包 名 ， 它 有 两 个 方 
法 : prepare () 与 testReadAccount () 。 其 中 prepare () 方法 使 用 了 
@Before 标 注 ， 表 示 在 执行 测试 用 例 之 前 执行 该 方法 。 它 首先 检查 数据 
存储 文件 是 否 存在 ， 如 果 存 在 则 将 其 删除 以 得 到 干净 的 测试 环境 ， 接 
着 使 用 account-persist.xml 配 置 文 件 初始 化 SpringFramwork 的 IoC 容 器 ， 
再 从 容器 中 获取 要 测试 的 AccountPersistService 对 象 。 最 后 ，prepare 
O 方法 创建 一 个 Account 对 象 ， 设置 对 象 字段 的 值 之 后 ， 使 用 


AccountPersistServiceHcreateAccount () 方法 将 其 持久 化 。 


使 用 @Test 标 注 的 testReadAccount () 方法 就 是 要 测试 的 方法 。 该 
方法 非常 简单 ， 它 根据 id 使 用 AccountPersistService 读 取 Account 对 象 ， 
然后 检查 该 对 象 不 为 空 ， 并 且 每 个 字段 的 值 必须 与 刚才 播 入 的 对 象 的 
值 完 全 一 致 。 


该 测试 用 例 芝 守 了 测试 接口 而 不 测试 实现 这 一 原则 。 也 束 古 说 ， 
测试 代码 不 能 引用 实现 类 ， 由 于 测试 是 从 接口 用 户 的 角度 编写 的 ， 这 
样 束 能 保证 接口 的 用 户 无 须知 晓 接口 的 实现 细 市 ， 既 保证 了 代码 的 解 
而 ， 也 促进 了 代码 的 设计 。 


到 目前 为 止 ， 本 书 实现 了 用 户 注册 服务 的 两 个 模块 ， 它 们 分 别 是 
第 5 章 实 现 的 account-email 和 本 章 实 现 的 account-persist。 这 时 ， 一 个 简 
单 的 需求 就 会 自然 而 然 地 显现 出 来 : 我 们 会 想 要 一 次 构建 两 个 项 目 ， 
而 不 是 到 两 个 模块 的 目录 下 分 别 执行 mvn 命 令 。Maven 聚 合 (或 者 称 大 
多 模块 ) 这 一 特性 就 是 为 该 需求 服务 的 。 


为 了 能 够 使 用 一 条 命令 就 能 构建 account-emai 和 account-persist 两 个 
模块 ， 我 们 需要 创建 一 个 额外 的 名 为 account-aggregator 的 模块 ， 然 后 通 
过 该 模块 构建 整个 项 目的 所 有 模块 。account-aggregator 本 身 作 为 一 个 
Maven 项 目 ， 它 必须 要 有 自己 的 POM， 不 过 ， 同 时 作为 一 个 聚合 项 
目 ， 其 POM 又 有 特殊 的 地 方 。 如 下 为 account-aggregator 的 pom.xml 内 
见 代 码 清 单 8-9。 


代码 清单 8-9 accountraggregator 的 POM 


aven. apache. org/POM/4.0.0" 


<packaging >pom < / 


<name >Account Aggregator < /name > 


<modules > 
<module > account-email < /module > 
< module >account-persist < /module > 
< /modules > 
< /project > 


上 述 POM 依 旧 使 用 了 账户 注册 服务 共同 的 groupId 
com.juvenxu.mvnbook.account，artifactId 为 独立 的 accountraggregator， 
版 本 也 与 其 他 两 个 模块 一 致 ， 为 1.0.0-SNAPSHOT 。 这 里 的 第 一 个 特殊 
的 地 方 为 packaging， 其 值 为 POM。 回 顾 accountr-email 和 account- 
persist， 它 们 都 没有 声明 packaging， 即 使 用 了 默认 值 jar。 对 于 聚合 模块 
来 说 ， 其 打包 方式 packaging 的 值 必须 为 pom， 否 则 就 无 法 构建 。 


POM 的 name 字 段 是 为 了 给 项 目 提供 一 个 更 容易 阅读 的 名 字 。 之 后 
是 本 书 之 前 都 没 提 到 过 的 元 素 modules， 这 是 实现 聚合 的 最 核心 的 配 
置 。 用 户 可 以 通过 在 一 个 打包 方式 为 pom 的 Maven 项 目 中 声明 任意 数量 
的 module 元 和 聂 来 实现 模块 的 聚合 。 这 里 每 个 module 的 值 都 是 一 个 当前 
POM 的 相对 目录 ， 壁 如 该 例 中 ，account-aggregator 的 POM 的 路 人 径 为 D: 
\. ..\code\ch-8\account-aggregator\pom.xml, #84 account-email iX] M J 
HKD: \...\code\ch-8\account-aggregator\account-email/, Mij account- 


persist] M F HKD: \...\code\ch-8\account-aggregator\account-persist/ ° 


这 两 个 目录 各 上 自 包含 了 pom.xml、src/main/java/、src/test/java/ 等 内 容 ， 
离开 account-aggregator 也 能 独立 构建 。 


一 般 来 说 ， 为 了 方便 快速 定位 内 容 ， 模 块 所 处 的 目录 名 称 应 当 与 
其 artifactId 一 致 ， 不 过 这 不 是 Maven 的 要 求 ， 用 户 也 可 以 将 account- 
email 项 目 放 到 email-account/ 目 录 下 。 这 时 ， 聚 合 的 配置 就 需要 相应 地 


改 成 <module>email-account</module> ° 


为 了 方便 用 户 构 建 项 目 ， 通 常 将 聚合 模块 放 在 项 目 目 录 的 最 顶 
屋 ， 其 他 模块 则 作为 罕 合 模块 的 子 日 隶 存 在 ， 这 样 当 用 户 得 到 源码 的 
时 候 ， 第 一 眼 发 现 的 就 是 聚合 模块 的 POM， 不 用 从 多 个 模块 中 去 寻找 
聚合 模块 来 构建 整个 项 目 。 图 8-1 所 示 为 account-aggregator 与 另外 两 个 
模块 的 目录 结构 关系 。 


从 图 8-1 中 能 够 看 到 ，account-aggregator 的 内 容 仅 是 一 个 pom.xml 文 
件 ， 它 不 像 其 他 模块 那样 有 src/main/java、src/test/java 等 目录 。 这 也 是 
SS SE, KARR MEHR Hh REN LR, EAE 
并 无 实质 的 内 容 。 


关于 目录 结构 还 需要 注意 的 是 ， 聚 合 模 块 与 其 他 模块 的 目录 结构 
并 非 一 定 要 是 父子 关系 。 图 8-2 展 示 了 为 一 种 平行 的 目 了 结构 。 


tx account-aggregator 
mi JRE System Library [jre1.6. 
GG account-email 


& src 

i= target 

‘ml pom.xml 
EE account-persist 

& src 

Œ target 

‘ml pom.xml 
m pom.xml 


图 8-1 聚合 模块 的 父子 目录 结构 


4 (> account-aggregator 
m) pom.xml! 
(= account-email 


æ src 
© target 


m) pom.xml 
= account-persist 


& src 
© target 
‘| pom.xml 


图 8-2 RARR FITH RKA 


如 采 使 用 平行 目录 结构 ， 聚 合 模 块 的 POM 也 需要 做 相应 的 修改 ， 
DAT IF) LEAH RE H 3R: 


<modules > 
<module >.. /account-email < /module > 
<module>../account-persist < /module > 
< /modules > 


最 后 ， 为 了 得 到 直观 的 感受 ， 看 一 下 从 聚合 模块 运行 mvn clean 
install 命 令 会 得 到 怎样 的 输出 : 


[INFO] Scanning for projects... 

PERE coin ane ee ei 
[INFO] Reactor Build Order: 

[INFO} 

[INFO] Account Aggregator 

[INFO] Account Email 

[INFO] Account Persist 

[INFO] 

全 NE 
[INFO] Building Account Aggregator 1.0.0-SNAPSHOT 

[INPO] he ee re re erator 
[INFO] ... 

[INFO] -一 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Building Account Email 1.0.0-SNAPSHOT 

[INFO] .一 一 一 一 一 一 一 一 一 了 一 一 一 一 一 一 一 一 一 一 二 一 一 二 一 一 一 一 一 二 一 一 二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 -一 一 一 一 一 一 一 二 一 一 二 = 二 


[INFO] ... 

[INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Building Account Persist 1.0.0-SNAPSHOT 

nh tte te EN 
[INFO] ... 

[INFO] 一 一 -一 一 一 -一 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 -一 一 一 -一 一 一 -一 一 一 一 
[INFO] Reactor Summary: 

[INFO] 

[INFO] Account Aggregator s.s ss seess sesse e SUCCESS [0.4965] 

(INEGI ACCOUN E EAL opm EE: (4372 

[INFO] Account Persist ei he anaa SUCCESS [2.1765] 

[INFO] 一 -一 一 一- 一 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] BUILD SUCCESS 

(THEO) ioe een eee weer eee 
[INFO] Total time: 6.158s 

[INFO] Finished at: Sun Feb 14 16:36:29 CST 2010 

[INFO] Final Memory: 11M/20M 

[INFOQ] =-=--22- ss E eB es 


会 首先 解析 聚合 模块 的 POM、 分 析 要 构建 的 模块 、 并 计算 出 一 个 
有 反应堆 构建 顺序 (Reactor Build Order) ， 然 后 根据 这 个 顺序 依次 构建 


各 个 模块 。 反 应 堆 是 所 有 模块 组 成 的 一 个 构建 结构 。8.6 届 会 详细 讲述 
Maven 的 反应 堆 。 


上 述 输出 中 显示 的 是 各 模块 的 名 称 ， 而 不 是 artifactd， 这 也 解释 了 
为 什么 要 在 POM 中 配置 合理 的 name 字 段 ， 其 目的 是 让 Maven 的 构建 输 
出 更 清晰 。 和 输出 的 最 后 是 一 个 项 目 构建 的 小 结 报告 ， 包 括 各 个 模块 构 
建成 功 与 否 、 人 花费 的 时 间 ， 以 及 整个 构建 花费 的 时 间 、 使 用 的 内 存 


BE o 
可 


8.3 ”继承 


到 目前 为 止 ， 我 们 已 经 能 够 使 用 Maven 的 聚合 特性 通过 一 条 命令 
同时 构建 account-email 和 account-persist 两 个 模块 ， 不 过 这 仅仅 解决 了 
多 模块 Maven 项 目的 一 个 问题 。 那 么 多 模块 的 项 目 还 有 什么 问题 呢 ? 


细心 的 读者 可 能 已 经 比较 过 5.3.1 节 和 8.1.1 节 ， 这 两 个 POM 有 着 很 
多 相同 的 配置 ， 例 如 它们 有 相同 的 groupId 和 version， 有 相同 的 spring- 
core、spring-beans、spring-context 和 junit 依 赖 ， 还 有 相同 的 maven- 


compiler-plugin 与 maven-resources-plugin 配 置 。 程 序 员 的 嗅觉 对 这 种 现 
象 比较 敏感 ， 没 错 ， 这 是 重复 ! 大 量 的 前 人 经 验 告 诉 我 们 ， 重 复 往 往 
就 意味 着 更 多 的 劳动 和 更 多 的 潜在 的 问题 。 在 面向 对 象 世 界 中 ， 程 序 
员 可 以 使 用 类 继承 在 一 定 程度 上 消除 重复 ， 在 Maven 的 世界 中 ， 也 有 
类 似 的 机 制 能 让 我 们 抽取 出 重复 的 配置 ， 这 就 是 POM 的 继承 。 


8.3.1 account-parent 


面向 对 象 设 计 中 ， 程 序 员 可 以 建立 一 种 类 的 父子 结构 ， 然 后 在 父 
类 中 声明 一 些 字 段 和 方法 供 子 类 继承 ， 这 样 束 可 以 做 到 “一 处 声明 ， 多 
处 使 用 ”。 类 似 地， 我 们 需要 创建 POM 的 父子 结构 ， 然 后 在 父 POM 中 声 
明 一 些 配置 供 子 POM 继 承 ， 以 实现 “一 处 声明 ， 多 处 使 用 ”的 目的 。 


我 们 继续 以 账户 注册 服务 为 基础 ， 在 account-aggregator 下 创建 一 个 
名 为 account-parent 的 子 目录 ， 然 后 在 该 子 目 录 下 建立 一 个 所 有 除 
account-aggregator 之 外 模块 的 父 模块 。 为 此 ， 在 该 子 目 录 创 建 一 个 
pom.xml 文 件 ， 内 容 见 代码 清单 8-10。 


代码 清单 8-10 account-parent 的 POM 


<project xmlns = "http://maven.apache.org/POM/4.0.0" 
xmlns:xsi = "http;://www.w3.o0rg/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http://maven.apache.org/POM/4.0.0 
http://maven. apache. org /maven-vå_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId> 


<version >1.0.0-SNAPSHOT < /version > 


<name >Account Parent < /name > 


该 POM 十 分 简单 ， 它 使 用 了 与 其 他 模块 一 致 的 groupId 和 version ， 
使 用 的 artifactId 为 account-parent 表 示 这 是 一 个 父 模块 。 需 要 特别 注意 的 


是 ， 它 的 packaging 为 pom， 这 一 点 与 聚合 模块 一 样 ， 作 为 父 模块 的 
POM， 其 打包 类 型 也 必须 为 pom 。 


由 于 父 模 块 只 是 为 了 帮助 消除 配置 的 重复 ， 因 此 它 本 身 不 包含 除 
POM 之 外 的 项 目 文 件 ， 也 就 不 需要 src/main/java/ 之 类 的 文件 夹 7。 


有 了 父 模块 ， 就 需要 让 其 他 模块 来 继承 它 。 首 先 将 account-email 的 
POM 修 改 如 下 ， 见 代码 清单 8-11。 


代码 清单 8-11 ”修改 account-email 继 承 account-parent 


<pro eoE seng http://maven.apache.org/POM/4.0.0" 
xmlns :xsi = "ht x eee, RB .org/2001 /XMLS TP ma-instar 

xSi:schemaLocation = "http: // MAV Ren eine he. org /POM of 0.0 
0.xsd"> 


http: //maven. apache. org/maven-v 


<modelVersion >4.0.0 < /modelVersion > 
<parent 
roup! Id > juvenxu.mvnbook. account < /groupId > 
<artifact oe >account en t</artifactId> 
<version >1.0.0-SNAPSHOT < /version > 
<relativePath>../accour Gist penne /pom. xml < /relativePath > 
< /parent > 


<artifactId >account-email < /artifactId> 
<name >Account Email < /name > 


< dependencies > 
< /dependencies > 


<build> 
<plugins > 


< /plugins > 
/puild > 


< /project > 


上 述 POM 中 使 用 parent 元 素 声 明 父 模块 ，parent 下 的 子 元 素 
groupId、artifactIld 和 version 指 定 了 父 模块 的 坐标 ， 这 三 个 元 素 是 必须 
的 。 元 素 relativePath 表 示 父 模块 POM 的 相对 路 径 ， 该 例 中 的 ../account- 
parent/pom.xml 表 示 父 POM 的 位 置 在 与 account-email/ 目 录 平 行 的 
account-parent/ 目 录 下 。 当 项 目 构 建 时 ，Maven 会 首先 根据 relativePath 检 
查 人 多 POM， 如 果 找 不 到 ， 再 从 本 地 仓库 查找 。relativePath 的 默认 值 
是 ../pom.xml， 也 就 是 说 ，Maven 默 认 人 从 POM 在 上 一 层 目 录 下 。 


正确 设置 relativePath 非 党 重要。 考虑 这 样 一 个 情况 ， 开 发 团队 的 新 
成 员 从 源码 库 签 出 一 个 包 侣 父子 模块 关系 的 Maven 项 目 。 由 于 只 关心 其 
中 的 某 一 个 子 模块 ， 它 就 直接 到 该 模块 的 目录 下 执行 构建 ， 这 个 时 
候 ， 父 模块 是 没有 被 安装 到 本 地 仓库 的 ， 因 此 如 果子 模块 没有 设置 正 
确 的 relativePath，Maven 将 无 法 找到 父 POM， 这 将 直接 导致 构建 失败 。 
如 有 果 Maven 能 够 根据 relativePath 找 到 父 POM， 它 就 不 需要 再 去 检查 本 地 
BE» 


这 个 更 新 过 的 POM 没 有 为 account-email 声 明 groupId 和 version， 不 
过 这 并 不 代表 account-email 没 有 groupId 和 version。 实 际 上 ， 这 个 子 模块 
隐 式 地 从 父 模 块 继 承 了 这 两 个 元 素 ， 这 也 束 消 除了 一 些 不 必要 的 配 
置 。 在 该 例 中 ， 父 子 模块 使 用 同样 的 groupId 和 version， 如 有 宁 遇 到 子 模 
块 需要 使 用 和 父 模块 不 一 样 的 groupId 或 者 version 的 情况 ， 那 么 用 户 完 
全 可 以 在 子 模块 中 显 式 声 明 。 对 于 artifactId 元 素来 说 ， 子 模块 应 该 显 式 


声明 ， 一 方面 ， 如 果 完 全 继承 groupId、artifactId 和 version， 会 造成 坐标 
冲突 ， 男 一 方面 ， 即 使 使 用 不 同 的 groupId 或 version， 同 样 的 artifactId 容 
易 造 成 温 消 。 


为 了 廊 省 骗 幅 ， 上 述 POM 中 省 略 了 依赖 配置 和 插件 配置 ， 稍 后 本 
章 会 介绍 如 何 将 共同 的 依赖 配置 提取 到 父 模 块 中 。 


与 account-email 的 POM 类 似 ， 以 下 是 account-persist 更 新 后 的 
POM， 见 代码 清单 8-12 。 


代码 清单 8-12 ”修改 account-persist 继 承 account-parent 


xmlns = "http://maven. apache. org/POM/4.0.0" 
' 


"http: //www.w3.org/2001 /XMLSchema-instē 


xSi:schemaLocation ="“http://n he.org/POM/4.0.0 


http: //maven, apache. org/maven-v4_[ 


<modelVersion >4.0.0 < /modelVersic 

<parent > 
< groupid >com. juvenxu.mvnbook. account < /groupId > 
<artifactiId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 


<relativePath>,./account-parent /pom. xml < /relativePath > 


<artifactId >account-persist < /artifactid> 
<name >Account Persist < /name > 


< dependencies > 
< /dependencies > 


<build> 
<testResources > 
<testResource > 
<directory >src/test/resources < /directory > 
<filtering >true < /filtering > 
< /testResource > 
< /testResources > 
<plugins > 


< /plugins > 
< /build> 
< /project > 


最 后 ， 同 样 还 需要 把 account-parent 加 入 到 聚合 模块 account- 
aggregator 中 ， 见 代码 清单 8-13 ° 


代码 清单 8-13 ”将 account-parent 加 入 到 聚合 模块 


<project xmlns = "http://maven. apache. org/POM/4.0.0" 
xmins:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi :schemaLocation = "http://maven. apache. org/POM/4.0.0 
http://maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < /modelVersion > 
<groupid > com. juvenxu.mvnbook. account < /groupId > 
<artifactid >account-aggregator < /artifactId> 
<version >1.0.0-SNAPSHOT < /version > 
< packaging >pom < /packaging > 
<name >Account Aggregator < /name > 
<modules > 
<module >account-parent < /module > 
<module >account-email < /module > 
<module >account-persist < /module > 
< /modules > 


8.3.2 ”可 继承 的 POM 元 素 


在 上 一 太 我 们 看 到 ，groupId 和 version 是 可 以 被 继承 的 ， 那 么 还 有 
哪些 POM 元 系 可 以 被 继承 呢 ? 以 下 是 一 个 完整 的 列表 ， 并 附 市 了 人 简单 
的 说 明 : 


“groupId: 项 目 组 ID， 项 目 坐 标的 核心 元 素 。 
‘version: 项 目 版 本 ， 项 目 坐标 的 核心 元 素 。 
‘description: 项 目的 描述 信息 。 

‘organization: 项 目的 组 织 信息 。 
-inceptionYear: 项 目的 创始 年 份 。 

‘url: 项 目的 URL 地 址 。 

-developers: 项 目的 开发 者 信息 。 
‘contributors: 项 目的 贡献 者 信息 。 
-distributionManagement: 项 目的 部 署 配置 。 


-issueManagement: 项 目的 缺陷 跟 踩 系统 信息 。 


-ciManagement: 项 目的 持续 集成 系统 信息 。 


‘sem: 项 目的 版 本 控制 系统 信息 

‘mailingLists: 项 目的 邮件 列表 信息 。 
‘properties: 目 定义 的 Maven 属 性 。 
"dependencies: 项 目的 依赖 配置 。 
-dependencyManagement: 项 目的 依赖 管理 配置 。 


‘repositories: 项 目的 仓库 配置 。 


‘build: 包括 项 目的 源码 目录 配置 、 输 出 目 隶 配置、 插件 配置 、 插 
件 管理 配置 等 。 


:reporting: 包括 项 目的 报告 输出 目 隶 配置、 报告 插件 配置 等 。 


8.3.3 (RTE 
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被 继承 的 ， 这 时 我 们 就 会 很 容易 想到 将 这 一 特性 应 用 到 account-parent 
中 。 子 模块 account-email 和 account-persist 同 时 依赖 了 
org.springframework: spring-core: 2.5.6 ` org.springframework: spring- 
beans: 2.5.6 ` org.springframework: spring-context: 2.5.6 和 junit: 
junit: 4.7， 因 此 可 以 将 这 些 依赖 配置 放 到 父 模 块 account-parent 中 ， 两 
个 子 模块 就 能 移 除 这 些 依赖 ， 人 简化 配置 。 


上 述 做 法 是 可 行 的 ， 但 却 存在 问题 。 到 目前 为 止 ， 我 们 能 够 确定 
这 两 个 子 模块 都 包含 那 四 个 依赖 ， 不 过 我 们 无 法 确定 将 来 添加 的 子 模 
块 就 一 定 需 要 这 四 个 依赖 。 假 设 将 来 项 目 中 需要 加 入 一 个 account-util 模 
块 ， 该 模块 只 是 提供 一 些 简单 的 帮助 工具 ， 与 springframework 完 全 无 
关 ， 难 道 也 让 它 依赖 spring-core、spring-beans 和 spring-context 吧 ? 那 显 
然 是 不 合理 的 。 


Maven 提 供 的 dependencyManagement 元 素 既 能 让 子 模 块 继承 到 父 模 
块 的 依赖 配置 ， 又 能 保证 子 模块 依赖 使 用 的 灵活 性 。 在 
dependencyManagement 元 又 下 的 依赖 声明 不 会 引入 实际 的 依赖 ， 不 过 
它 能 够 约束 dependencies 下 的 依赖 使 用 。 例 如 ， 可 以 在 account-parent 中 
加 入 这 样 的 dependencyManagement 配 置 ， 见 代码 清单 8-14。 


代码 清单 8-14 在 account-parent 中 配置 dependencyManagement 元 素 


<project 

xmlns = "http://maven. apache. org/POM/4.0.0" 

xmins:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http://maven. apache. org/POM/4.0.0 


http: //maven. apache. org /maven-v4_0_0.xsd* > 
<modelVersion >4.0.0 < /modelVersion > 
<groupid >com. juvenxu. mvnbook. account < /GroupId > 
<artifactId >account-parent < /artifactid> 
<version >1.0.0-SNAPSHOT < /version > 
< packaging > pom < /packaging > 
<name >Account Parent < /name > 
<properties > 
<springframework. version >2,5.6 < /springframework, version > 
<junit.version >4.7 </junit.version > 
< /properties > 
< dependencyManagement > 
<dependencies > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId >spring-core < /artifactId > 
<version> $ {(springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupId >org. springframework < /group!Id > 
<artifactId >spring—-beans < /artifactId > 
<version > $ (springframework, version} < /version > 
< /dependency > 
«dependency > 
<groupid > org. springframework < /groupid > 
<artifactid>spring-context < /artifactId > 
<version > $ {springframework. version} < /version > 
< (dependency > 
< dependency > 
<qgroupid >org. springframework < /groupid > 
<artifactiId >spring-context-support < /artifactId> 
<version> $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<grouplId > junit < /groupld > 
<artifactId>junit < /artifactId> 
<version> $ (junit. version} < /version> 
<scope >test < /scope > 
< /dependency > 
< /dependencies > 
< /dependencyManagement > 
</project > 


首先 该 多 POM 使 用 了 5.9.2 节 介绍 的 方法 ， 将 springframeworkk 和 
junit 依 赖 的 版 本 以 Maven 变 量 的 形式 提取 了 出 来 ， 不 仅 消 除了 一 些 重 
复 ， 也 使 得 各 依赖 的 版 本 处 于 更 加 明显 的 位 置 。 


这 里 使 用 dependencyManagement 声 明 的 依赖 既 不 会 给 account- 
parent 引 入 依赖 ， 也 不 会 给 它 的 子 模块 引入 依赖 ， 不 过 这 上 段 配 置 是 会 被 
继承 的 。 现 在 修改 account-email 的 POM 如 下 ， 见 代码 清单 8-15。 


代码 清单 8-15 ”继承 了 dependencyManagement 的 account-email 
POM 


<greenmail.version >1.3.1b< /greenmail.version > 
< /properties > 


< dependencies > 
< dependency > 
<groupId >org. springframework < /groupId > 
<artifactId >spring-core < /artifactId > 
< /dependency > 
< dependency > 
<groupiId > org. springframework < /groupId > 
<artifactId >spring-beans < /artifactId> 
< /dependency > 
< dependency > 
<groupid >org. springframework < /qroupId > 
<artifactId >spring-context < /artifactId > 
< /dependency > 
< dependency > 
< groupid >org. springframework < /groupId > 
<artifactId >spring-context-support < /artifactId> 
< /dependency > 
< irr > 
sare upId > jur < /groupld > 
rtifact Id > > junit < /artifactiId > 
< Fie ndency > 
< dependency > 
<groupId > javax. mail < ae oe 
<artifact id > mail < /artifact! 
<version> $ {javax.mail.version} < /version > 
< pb es > 
< dependency > 
< Botany aie com. icegreen < SAITO 
cartifactI pi greenmail < : /arti factid> 
<version> $ {greenmail. version} < /version > 
< scope >test < /scope > 
< /dependency > 
< /dependencies > 


上 述 POM 中 的 依赖 配置 较 原 来 简单 了 一 些 ， 所 有 的 
springframework 依 赖 只 配置 了 groupId 和 artifactId4， 省 去 了 version， 而 
junit 依 赖 不 仅 省 去 了 version， 还 省 去 了 依赖 范围 Scope。 这 些 信息 可 以 
省 略 是 因为 account-email 继 承 了 account-parent 中 的 
dependencyManagement 配 置 ， 完 整 的 依赖 声明 已 经 包含 在 父 POM 中 ， 
子 模块 只 需要 配置 简单 的 groupId 和 artifactId 就 能 获得 对 应 的 依赖 信息 ， 
从 而 引入 正确 的 依赖 。 


使 用 这 种 依赖 管理 机 制 似乎 不 能 减少 太 多 的 POM 配 置 ， 不 过 笔者 
还 是 强烈 推荐 采用 这 种 方法 。 其 主要 原因 在 于 在 父 POM 中 使 用 
dependencyManagement 声 明 依赖 能 够 统一 项 目 范 围 中 依赖 的 版 本 ， 当 
依赖 版 本 在 父 POM 中 声明 之 后 ， 子 模块 在 使 用 依赖 的 时 候 惑 无 顷 声明 
版 本 ， 也 就 不 会 发 生 多 个 于 模块 使 用 依赖 版 本 不 一 致 的 情况 。 这 可 以 
帮助 降低 依赖 冲突 的 几率 。 


如 有 果子 模块 不 声明 依赖 的 使 用 ， 即 使 该 依赖 已 经 在 父 POM 的 
dependencyManagement 中 声明 了 ， 也 不 会 产生 任何 实际 的 效果 ， 如 
account-persist 的 POM， 见 代码 清单 8-16。 


代码 清单 8-16 ”继承 了 dependencyManagement 的 account-persist 


POM 


<properties > 


<dom4j.version >1.6.1 < /dom4j. version > 


< /properties > 


< dependencies > 


< dependency > 


<grouplid >dom4j < /groupid > 
<artifactiId >dom4j < /artifactId> 


version > $ {dom4j.version} < /version > 


<artifactiId >spring-core < /artifactId> 


< /dependency > 


< dependency > 


pringframework < /groupId > 


Id >spring-beans < /artifactId > 


<dependency > 


<groupid >org. springframework < /groupId > 
<artifactId >spring-context < /artifactId > 


< /dependency > 


< dependency > 


<groupid > junit < /grouplId > 
<artifactiId >junit < /artifactid > 


< / dependency > 
< /dependencies > 


这 里 没有 声明 spring-context-support， 那 么 该 依赖 就 不 会 被 引入 。 


这 正 是 dependencyManagement 的 灵活 性 所 在 。 


5.5 节 在 介绍 依赖 范围 的 时 候 提 到 了 名 为 Import 的 依赖 范围 ， 推 迟 


到 现在 介 


一 


绍 是 因为 该 范围 的 依赖 只 在 dependencyManagement 元 素 下 才 


有 效果 ， 使 用 该 范围 的 依赖 通常 指向 一 个 POM， 作 用 是 将 日 标 POM 中 
的 dependencyManagement 配 置 导 入 并 合并 到 当前 POM 的 
dependencyManagement 元 素 中 。 例 如 想 要 在 另外 一 个 模块 中 使 用 与 代 
码 清单 8-14 完 全 一 样 的 dependencyManagement 配 置 ， 除 了 复制 配置 或 者 


继承 这 两 种 方式 之 外 ， 还 可 以 使 用 import 艺 围 依赖 将 这 一 配置 导入 ， 


代码 清单 8-17。 


代码 清单 8-17 BEH importy ECR AKEN E BRAC E. 


= 


< dependencyManagement > 


< dependencies > 


< dependency > 
<groupid >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId > 


W: 


注意 ， 上 述 代 码 中 依赖 的 type 值 为 ppom，import 范 围 依赖 由 于 其 特 
殊 性 ， 一 般 都 是 指向 打包 类 型 为 pom 的 模块 。 如 果 有 多 个 项 目 ， 它 们 使 


用 的 依赖 版 本 都 是 一 致 的 ， 则 束 可 以 定义 一 个 使 用 


dependencyManagement 专 门 管 理 依赖 史 POM， 人 然后 在 各 个 项 目 中 导入 


这 些 依赖 管理 配置 。 


8.3.4 ”插件 管理 


Maven 提 供 了 dependencyManagement 元 素 帮 助 管理 依赖 ， 类 似 地 ， 
Maven 也 提供 了 pluginManagement 元 素 帮 助 管理 插件 。 在 该 元 素 中 配置 
的 依赖 不 会 造成 实际 的 插件 调用 行为 ， 当 POM 中 配置 了 真正 的 plugin 元 
素 ， 并 且 其 groupId 和 artifactId 与 pluginManagement 中 配置 的 插件 匹配 
时 ，pluginManagement 的 配置 才 会 影响 实际 的 插件 行为 。 


7.4.2 节 中 配置 了 maven-source-plugin， 将 其 jar-no-fork 目 标 绑 定 到 了 
verity 生 命 周 期 阶段 ， 以 生成 项 目 源码 包 。 如 果 一 个 项 目 中 有 很 多 子 模 
块 ， 并 且 需 要 得 到 所 有 这 些 模 块 的 源码 包 ， 那 么 很 显然 ， 为 所 有 模块 
重复 类 似 的 插件 配置 不 是 最 好 的 办 法 。 这 时 更 好 的 方法 是 在 父 POM 中 
使 用 pluginManagement 配 置 插件 ， 见 代码 清单 8-18。 


代码 清单 8-18 在 父 POM 中 配置 pluginManagement 


<build> 
<pluginManagement > 
<plug ins > 
<plugin > 

< groupld >org. apache. maven. plugins < /groupId > 

<artifactId >maven-source-plugin < /artifactId > 

<version >2.1.1</version> 

<executions > 

<execution > 
<id>attach-sources < /id> 
<phase >verify < /phase > 
<goalis > 
<goal > jar-no-fork < /goal > 
< /goals > 
< fexecution > 
< /executions > 
< /plugin > 
< /plugins > 
< /pluginManagement > 
< /build > 


当 子 模块 需要 生成 源码 包 的 时 候 ， 只 需要 如 下 简单 的 配置 ， 见 代 
码 清单 8-19。 


代码 清单 8-19 ”继承 了 pluginManagement 后 的 揪 件 配置 


<build> 
< plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 


<artifactid >maven-source-plugin < /artifactId > 
< /plugin > 
< /plugins > 
< /build> 


子 模块 声明 使 用 了 maven-source-plugin 揪 件 ， 同 时 又 继承 了 父 模 块 
的 pluginManagement 配 置 ， 两 者 基于 groupId 和 artifactId 匹 配合 并 之 后 就 
相当 于 7.4.2 节 中 的 插件 配置 。 


如 果子 模块 不 需要 使 用 父 模 块 中 pluginManagement 配 置 的 插件 ， 可 
以 尽管 将 其 忽略 。 如 果子 模块 需要 不 同 的 插件 配置 ， 则 可 以 自行 配置 
以 履 盖 父 模块 的 pluginManagement 配 置 。 


有 了 pluginManagement 元 素 ，account-email 和 account-persist 打 POM 
也 能 得 以 简化 了 ， 它 们 都 配置 『- maven-compiler-plugin 和 maven- 
resources-plugin。 可 以 将 这 两 个 插件 的 配置 移 到 account-parent 的 
pluginManagement 元 素 中 ， 见 代码 清单 8-20。 


代码 清单 8-20 account-parent 的 pluginManagement 配 置 


<build> 
<pluginManagement > 
<plugins > 
<plugin > 
< groupId >org. apache. maven. plugins < /groupId > 


< configuration > 


< source >1.5 </source> 
tis /target 
< /configuration > 


< /plugin > 
<plugin> 
<groupid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-resources-plugin < /artifactId> 
< configuration > 
<encoding >UTF-8 < /encoding > 


< /plugin > 
< /plugins > 
< /pluginManagement > 


< f/build> 


account-email 和 account-persist 可 以 完全 地 移 除 天 于 maven-compiler- 
plugin 和 maven-resources-plugin 的 配置 ， 但 它们 仍 能 享受 这 两 个 插件 的 
服务 ， 前 一 插件 开局 了 Java 5 编译 的 文 持 ， 后 一 插件 也 会 使 用 UTF-8 编 


码 处 理 资 源 文 件 。 这 背后 涉及 了 很 多 Maven 机 制 ， 首 先 ， 内 置 的 插件 绑 
定 关 系 将 两 个 插件 绑 定 到 了 account-email 和 account-persist 的 生命 周期 
E; 其 次 ， 超 级 POM 为 这 两 个 搬 件 声明 了 版 本 ; 最 后 ，account-parent 
中 的 pluginManagement 对 这 两 个 插件 的 行为 进行 了 配置 。 


当 项 目 中 的 多 个 模块 有 同样 的 插件 配置 时 ， 应 当 将 配置 移 到 父 
POM 的 pluginManagement 元 素 中 。 即 使 各 个 模块 对 于 同一 插件 的 具体 
配置 不 尽 相 同 ， 也 应 当 使 用 父 POM 的 pluginManagement 元 素 统一 声明 
插件 的 版 本 。 甚 至 可 以 要 求 将 所 有 用 到 的 插件 的 版 本 在 父 POM 的 
pluginManagement 元 素 中 声明 ， 子 模块 使 用 插件 时 不 配置 版 本 信息 ， 这 
么 做 可 以 统一 项 目的 插件 版 本 ， 避 免 洪 在 的 插件 不 一 致 或 者 不 稳定 问 
题 ， 也 更 易于 维护 。 


8.4 RATKA 


基于 前 面 三 节 的 内 容 ， 读 着 可 以 了 解 到 ， 多 模块 Maven 项 目 中 的 聚 
合 与 继承 其 实 是 两 个 概念 ， 其 目的 完全 是 不 同 的 。 前 者 主要 是 为 了 方 
全 快速 构 建 项 目 ， 后 者 主要 是 为 了 消除 重复 配置 。 


对 于 聚合 模块 来 说 ， 它 知道 有 哪些 被 聚合 的 模块 ， 但 那些 被 聚合 
的 模块 不 知道 这 个 聚合 模块 的 存在 。 


对 于 继承 天 系 的 多 POM 来 说 ， 它 不 知道 有 哪些 子 模块 继承 于 它 ， 
但 那些 子 模块 都 必须 知道 目 己 的 父 FPOM 是 什么 。 


如 有 果 非 要 说 这 两 个 特性 的 共同 点 ， 那 么 可 以 看 到 ， 聚 合 POM 与 继 
承 天 系 中 的 父 POM 的 packaging 都 必须 是 pom， 同 时 ， 聚 合 模块 与 继承 
关系 中 的 父 模 块 除了 POM 之 外 都 没有 实际 的 内 容 ， 如 图 8-3 所 示 。 


被 聚合 模块 
被 聚合 模块 


图 8-3 ”聚合 关系 与 继承 关系 的 比较 


TEVA WEI, BEHEER SPOMBt FEA POM, 
又 是 父 FOM， 这 人 么 做 主要 是 为 了 方便 。 一 般 来 说 ， 融 合 使 用 紊 合 与 继 
承 也 没有 什么 问题 ， 例 如 可 以 将 account-aggregator 和 account-parent 合 并 
成 一 个 新 的 account-parent， 其 POM 见 代码 清单 8-21 ° 


代码 清单 8-21 合并 聚合 和 继承 功能 后 的 account-parent 


<project xmlns = "http://maven. apache. org/POM/4.0,0" 


xmins:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "“http://maven. apache. org/POM/4.0.0 
http: //maven. apache. org/maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId > 
<version >1.0.0-SNAPSHOT < /version > 
< packaging >pom < /packaging > 
<name >Account Parent < /name > 
<modules > 

<module >account-email < /module > 


<module >account-persist < /module > 
< /modules > 
<properties > 
<springframework. version >2.5.6 < /springframework. version > 
<junit.version >4.7 </junit.version > 
< /properties > 
< dependencyManagement > 
< dependencies > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId>spring-core < /artifactId> 
<version > $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId >spring-beans < /artifactId > 
<version > $ {springframework. version} < /version > 
< /dependency > 
<dependency > 
<grouplid >org. springframework < /groupId > 
<artifactId >spring-context < /artifactId> 
<version> $ {springframework, version} < /version > 
< /dependency > 
< dependency > 
<groupid >org. springframework < /groupId > 
<artifactId >spring-context-support < /artifactId> 
<version> $ {springframework. version} < /version > 
< /dependency > 
< dependency > 
<groupid > junit < /groupid > 
<artifactId >junit < /artifactId> 
<version > $ {junit. version} < /version > 
<scope >test < /scope > 
< /dependency > 
< /dependencies > 
< /dependencyManagement > 
<build> 
<pluginManagement > 
<plugins > 
<plugin> 
< groupid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-compiler-plugin < /artifactid> 
<configuration > 
<source >1.5 </source> 
<target >1.5 </target > 
< /configuration > 
</plugin > 
<plugin > 
<groupid > org. apache. maven. plugins < /groupid > 
<artifactid >maven-resources-plugin < /artifactid> 
<configuration > 
<encoding >UTF-8 < /encoding > 
< /configuration > 
< /plugin > 
< /plugins > 


< /pluginManagement > 
/build > 


< /project > 


在 代码 清单 8-21 中 可 以 看 到 ， 该 POM 的 打包 方式 为 pom， 它 包含 了 
一 个 modules 元 素 ， 表 示 用 来 聚合 account-persist 和 account-email 两 个 模 


块 ， 它 还 包含 了 properties、dependencyManagement 和 PluginManagement 
元 素 供 子 模块 继承 。 


相应 地 ，accountremail 和 account-persist 的 POM 配 置 也 要 做 微小 的 修 
改 。 本 来 account-parent 和 它们 位 于 同 级 目录 ， 因 此 需要 使 用 值 
为 .Jaccount-parentpom.xml 的 relativePath 元 素 。 现 在 新 的 account-parent 
在 上 一 层 目 未 ， 这 是 Maven 默 认 能 识别 的 父 模 块 位 置 ， 因 此 不 再 需要 配 
置 relativePath， 见 代码 清单 8-22 。 


代码 清单 8-22” 当 父 模块 在 上 级 目录 时 不 再 需要 relativePath 


8.5 约定 优 于 配置 


标准 的 重要 性 已 不 用 过 多 强调 ， 想 象 一 下 ， 如 果 不 是 所 有 程序 员 
都 基于 HTTP 协议 开发 Web 应 用 ， 互 联网 会 乱 成 怎样 。 各 个 版 本 的 正 、 
Firefox 等 浏览 器 之 间 的 差别 已 经 让 很 多 开发 者 头痛 不 已 。 而 Java 成 功 的 
重要 原因 之 一 就 是 它 能 屏蔽 大 部 分 操作 系统 的 差异 ，XML 流 行 的 原因 
之 一 是 所 有 语言 都 接受 它 。Maven 当 然 还 不 能 和 这 些 既 成 功 又 成 熟 的 技 
术 相 比 ， 但 Maven 的 用 户 都 应 该 清楚 ，Maven 提 倡 “ 约 定 优 于 配 
‘.” (Convention Over Configuration) ， 这 是 Maven 最 核心 的 设计 理念 
之 一 。 


那么 为 什么 要 使 用 约定 而 不 是 自己 更 灵活 的 配置 呢 ? 原因 之 一 
是 ， 使 用 约定 可 以 大 量 减少 配置 。 先 看 一 个 简单 的 Ant 配 置 文件 ， 见 代 
码 清 单 8-23。 


代码 清单 8-23 ”构建 简单 项 目 使 用 的 Ant 配 置 文件 


<project name = "my-project" default = "dist" basedir=".' 
< description > 


simple example build file 
< /description > 
<! 一 设置 构建 的 全 局 属性 -一 > 
<property name = "sre" location ="src/main/java"/ > 
<property name = "build" location = "target /classes"/ > 


<property name = "dist" location = "target"/ > 


<target name=" init 


一 创 建 时 ia Ry --> 
<tstamp/ > 
< 1 创建 编译 使 用 的 构建 目录 一 -> 


<mkdir dir=" $ {build}"/> 


< /target > 


<target name = "compile" depends = "init" 


description "compl e the source " > 
<!-# java 代码 从 目录 $ {src} sra $ {build} --> 
< javac ete eas rc}" destdir =" $ {build}"/> 
/ ‘target > 


<target name = "dist" Revere "compile" 


description = "generate the distribution" 
<! jc 分 发 El x 一 一 > 


<mkdir dir="5$ {dist}/lib"/ > 


-将 $ {build} 目录 的 所 有 内 容 打 和 包 至 MyProject-S$ {DSTAMP}. jar file --> 


< Jar jarfile =" $ {dist}/lib/MyProject-—s$ {DSTAMP}. jar" basedir =" $ {bui 
< /target > 


target name = "clean" 


description = "clean up" > 
<1- 删除 S {build} 和 $ {dist} 目录 树 --> 
<delete dir =" $ {build}"/> 
-elete dir=" $ {dist}"/> 


< /target > 


</p 


roject > 


这 段 代 码 做 的 事情 就 是 清除 构建 目 永 、 创 建 目 孙 、 编 译 代 码 、 复 


制 依赖 至 目标 目录 ， 最 后 打包 。 


征 一 个 项 目 构建 要 完成 的 最 基本 的 


事情 ， 不 过 为 此 还 是 需要 写 很 多 的 XML 配置 : 源码 目录 是 什么 、 编 译 


目标 目录 是 什么 、 分 发 目录 是 什么 ， 等 等 。 用 户 还 需要 记 住 各 种 Ant 任 


mY 
务 命令 ， 


做 同样 的 事情 ，Maven 需 要 什么 配置 呢 ? Maven 只 需要 一 个 最 
的 POM ， 


如 delete、mkdir、javac 和 jar ° 


HXI 


见 代码 清单 8-24 。 


代码 清单 8-24 构建 简单 项 目 使 用 的 Maven 配 置 文件 


i= 


本 


单 


<modelVersion >4.0.0 < /modelVersion > 
<groupid > Com. juvenxu. mvnbook < /groupId > 
cartifactId >my-project < /artifactId> 


IAPC Te SS A iat, (FON SRR AB, Pe 
需要 付出 一 定 的 代价 的 ， 那 就 是 遵循 Maven 的 约定 。Maven 会 假设 用 户 
的 项 目 是 这 样 的 : 

源码 目录 为 src/main/java/ 

编译 输出 目录 为 target/classes/ 

-打包 方式 为 jar 

: 包 输 出 目录 为 target/ 

遵循 约定 虽然 损失 了 一 定 的 灵活 性 ， 用 户 不 能 随意 安排 目录 结 


构 ， 但 是 却 能 减少 配置 。 更 重要 的 是 ， 杂 人 循 约定 能 够 帮助 用 户 导 守 构 
建 标 准 。 


如 条 没 有 约定 ，10 个 项 目 可 能 使 用 10 种 不 同 的 项 目 目 永 结构 ， 这 
意味 着 交流 学 习 成 本 的 增加 ， 当 新 成 员 加 入 项 目的 时 候 ， 它 就 不 得 不 
化 时 间 去 学 习 这 种 构建 配置 。 而 有 了 Maven 的 约定 ， 大 家 都 知道 什么 目 
录放 什么 内 容 。 此 外 ， 与 Ant 的 目 定 义 目 标 名 称 不 同 ，Maven 在 命令 行 


聂 露 的 用 户 接口 是 统一 的 ， 像 mvn clean install 这 样 的 命令 可 以 用 来 构建 
几乎 任何 的 Maven 项 目 。 


也 许 这 时 候 有 读者 会 本， 如 果 我 不 想 章 守 约 定 该 怎么 办 ? 这 时 ， 
WATCH ACS, KAN BOA WS? 如 采 仅 仅 是 因为 喜好 ， 就 
不 要 要 个 性 ， 个 性 往往 意味 着 牺牲 通用 性 ， 意 味 着 增加 无 谓 的 复杂 
度 。 例 如 ，Maven 人 允许 你 自 定 义 源码 目录 ， 如 代码 清单 8-25 所 示 。 


代码 清单 8-25 ”使 用 Maven 自 定义 源码 目录 


<project > 
<modelVersion >4.0.0 < /modelVersion > 
<groupid > Com. juvenxu. mvnbook < /groupid > 
<artifactid >my-project < /artifactid> 
<version>1.0 </version > 
<build> 
<sourceDirectory >src/java < /sourceDirectory > 
</build> 
‘project > 


该 例 中 源码 目录 就 成 了 src/java 而 不 是 默认 的 src/main/java。 但 这 往 
主 会 造成 交流 问题 ， 习 惯 Maven 的 人 会 奇怪 ， 源 代码 去 哪里 了 ? 当 这 种 
自 定 义 大 量 存 在 的 时 候 ， 交 流 成 本 就 会 大 大 提高 。 只 有 在 一 些 特殊 的 
情况 下 ， 这 种 自 定义 配置 的 方式 才 应 该 被 正确 使 用 以 解决 实际 问题 。 
例如 你 在 处 理 遗 留 代码 ， 并 且 没 有 办 法 更 改 原来 的 目录 结构 ， 这 个 时 


候 就 只 能 让 Maven 受 协 。 


Ss 


本 书 曾 多 次 提 到 超级 POM， 任 何 一 个 Maven 项 目 都 隐 式 地 继承 目 
该 POM， 这 有 点 类 似 于 任何 一 个 Java 类 都 隐 式 地 继承 于 Object 类 。 


此 ， 大 量 超级 POM 的 配置 都 会 被 所 有 Maven 项 目 继承 ， 这 些 配 置 也 就 
成 为 了 Maven 所 提倡 的 约定 。 


对 于 Maven 3， 超 级 POM 在 文件 和 $MAVEN_HOME/lib/maven- 
model-builder-x.x.x.jar 中 有 的 org/apache/maven/model/pom-4.0.0.xml 路 径 
下 。 对 于 Maven 2， 超 级 POM 在 文件 $MAVEN HOME/ib/maven-x.x.x- 
uber.jar 中 的 org/apache/maven/project/pom-4.0.0.xml 目 好 下 。 这 里 的 x.x.x 
表示 Maven 的 具体 版 本 。 


超级 POM 的 内 容 在 Maven 2 和 Maven 3 中 基本 一 致 ， 现 在 分 段 看 一 
下 ， 见 代码 清单 8-26。 


代码 清单 8-26 ”超级 POM 中 关于 仓库 的 定义 


<repositories > 
< repository > 
<id>central</id> 
<name >Maven Repository Switchboard < /name > 
<url >http://repol.maven.org/maven2 < /url > 
< layout >default < /layout > 
<snapshots > 
< enabled > false < /enabled > 
< /snapshots > 
< /repository > 
< /repositories > 


<pluginRepositories > 
<pluginRepository > 
<id>central < /id > 
<name >Maven Plugin Repository < /name > 
<url >http://repol.maven.org/maven2 < /url > 
< layout >default < /layout > 
<snapshots > 
< enabled > false < /enabled > 
< /snapshots > 
<releases > 
<updatePolicy >never < /updatePolicy > 
< /releases > 
< /pluginRepository > 
< /pluginRepositories > 


首先 超级 POM 定 义 了 仓库 及 插件 仓库 ， 两 者 的 地 址 都 为 中 央 仓 库 
http://repol.maven.org/maven2， 并 且 都 天 闭 了 SNAPSHOT 的 支持 。 这 也 
就 解释 了 为 什么 Maven 默 认 就 可 以 按 需 要 从 中 央 仓 库 下 载 构件 。 


再 看 以 下 内 容 ， 见 代码 清单 8-27。 


代码 清单 8-27 超级 POM 中 关于 项 目 结构 的 定义 


<build> 
<dGirectory > $ {project.basedir}/target < /direc se > 


<outputDirectory > $ {project. build. directory}/classes < /ou won tDirectory > 
<finalName > $ {project.artifactId}-s rodai ct.version}< /finalName > 


< testOutputDirectory > $ (project. build.directory }/beatec! asses </testOut- 
putDirectory > 
< EE > $ {project.basedir}/src/main/jJava < /sourceDirectory > 
scriptSourceDirectory >srce/main/scripts < /scriptSourceDirectory > 
<testSourceDirectory > $ {project.basedir}/sre/test/java < /testSourceDi- 
rectory > 
< resources > 
< resource > 
<directory > $ (project. basedir}/src/main/resources < /directory > 
< f/resource > 
A 
<testResources > 
<testResource > 


<directory > $ {project. basedir}/src/test /resources < /directory > 
< /testResource > 
< /testResources > 


ik BRR re CT SU A SE aT se > SEP CST > RAH 
的 名 称 格式 、 测 试 代码 输出 目录 、 主 源码 目录 、 脚 本 源码 目录 、 测 试 
源码 目录 、 主 多 源 目录 和 测试 资源 目录 。 这 束 是 Maven 项 目 结构 的 约 


Ps 


KE o 
紧 接 着 超级 POM 为 核心 插件 设 定 版 本 ， 见 代码 清单 8-28。 


代码 清单 8-28 ”超级 POM 中 关于 插件 版 本 的 定义 


<pluginManagement > 
<plugins > 

<plugin> 
<artifactid >maven-antrun-plugin < /artifactid> 
<version >1.3 </version> 

< /plugin> 

<plugin > 
<artifactId >maven-assembly-plugin < /artifactid > 
<version >2.2-beta4 < /version > 

< /plugin > 

<plugin > 
<artifactId >maven-clean-plugin < /artifactId> 
<version >2.3 </version > 

< /plugin > 

<plugin:> 
<artifactId >maven-compiler-plugin < /artifactId > 
< version >2.0.2</version> 

< /plugin > 


< /plugins > 
< /pluginManagement > 


< /build > 


由 于 篇 幅 原 因 ， 这 里 不 完整 罗列 ， 访 者 可 目 己 找到 超级 POM T fit 
插件 的 具体 版 本 。Maven 设 定 核心 插件 的 原因 十 防止 由 于 插件 版 本 的 变 
化 而 造成 构建 不 稳定 。 


超级 POM 的 最 后 是 关于 项 目 报告 输出 目录 的 配置 和 一 个 天 于 项 目 
发 布 的 profile， 这 里 暂 不 深入 解释 。 后 面 会 有 相关 的 章节 讨论 这 两 项 配 
ae 


可 以 看 到 ， 超 级 POM 实 际 上 很 简单 ， 但 从 这 个 POM 我 们 融 能 够 知 
晓 Maven 约 定 的 由 来 ， 不 仅 理解 了 什么 是 约定 ， 为 什么 要 遵循 约定 ， 还 
能 明日 约定 是 如 何 实现 的 。 


8.6 ”反应堆 


在 一 个 多 模块 的 Maven 项 目 中 ， 反 应 堆 (Reactor) 是 指 所 有 模块 
组 成 的 一 个 构建 结构 。 对 于 单 模块 的 项 目 ， 反 应 扒 束 是 该 模块 本 吴 ， 
但 对 于 多 模块 项 目 来 说 ， 反 应 堆 就 包含 了 各 模块 之 间 继 承 与 依赖 的 关 
系 ， 从 而 能 够 目 动 计算 出 合理 的 模块 构建 顺序 。 


8.6.1 及 应 堆 的 构建 顺序 


本 廊 仍 然 以 账户 注册 服务 为 例 来 解释 反应 堆 。 首 先 ， 为 了 能 更 清 
楚 地 解释 反应 堆 的 构建 顺序 ， 将 accountraggregator 的 聚合 配置 修改 如 


<module >account—-email < /module > 
< module >account-persist < /module > 


<module >account-parent < /module > 


修改 完毕 之 后 构建 accountraggregator 会 看 到 如 下 的 输出 : 


PINRO) “ema 
[INFO] Reactor Build Order: 
[INFO 

NEC 


[INFO] Account Email 

[INFO] Account Persist 

[INFO] 

[INPO] ssartmASHERH ESAE eee eae ae ee ere es ie ere ee 


上 述 输出 告诉 了 我 们 反应 堆 的 构建 顺序 ， 它 们 依次 为 account- 
aggregator 、account-parent、account-email 和 account-persist。 我 们 知 
道 ， 如 果 按 顺序 读 取 POM 文 件 ， 首 先 应 该 读 到 的 是 account-aggregator 的 
POM， 实 际 情况 与 预料 的 一 致 ， 可 是 接 下 来 几 个 模块 的 构建 次 序 显然 
与 它们 在 聚合 模块 中 的 声明 顺序 不 一 致 ，account-parent 跑 到 了 account- 
email 前 面 ， 这 是 为 什么 呢 ? 为 了 解释 这 一 现象 ， 先 看 图 8-4。 


account-aggregator 
account-email 
\ 


account-persist \ 


N 
account-parent 


图 8-4 IKA EMRA ARRS E 


图 8-4 中 从 上 至 下 的 箭头 表示 POM 的 读 取 次 序 ， 但 这 不 足以 决定 反 
应 扒 的 构建 顺序 ，Maven 还 需要 考虑 模块 之 间 的 继承 和 依赖 和 关系， 图 中 
的 有 向 虚 连 接线 表示 模块 之 间 的 继承 或 者 依赖 《本章 以 下 内 容 使 用 依 
赖 泛 指 这 种 模块 间 的 依赖 或 继承 关系 ) ， 该 例 中 account-email 和 
account-persist 依 赖 于 account-parent， 那 么 account-parent 就 必须 先 于 另 
外 两 个 模块 构建 。 也 就 是 说 ， 这 里 还 有 一 个 从 右 向 左 的 箭头 。 实 际 的 
构建 顺序 是 这 样 形成 的 : Maven 按 序 读 取 POM， 如 果 该 POM 没 有 依赖 
模块 ， 那 么 就 构建 该 模块 ， 否 则 就 先 构 建 其 依赖 模块 ， 如 果 该 依赖 还 
依赖 于 其 他 模块 ， 则 进一步 先 构 建 依赖 的 依赖 。 该 例 中 ，account- 
aggregator 没 有 依赖 模块 ， 因 此 先 构 建 它 ， 接 着 到 account-email， 它 依 
赖 于 account-parent 模 块 ， 必 须 先 构 建 account-parent， 然 后 再 构建 


account-email， 最 后 到 account-persist 的 时 候 ， 由 于 其 依赖 模块 已 经 被 构 
建 ， 因 此 直接 构建 它 。 


模块 间 的 依赖 天 系 会 将 反应 堆 构 成 一 个 有 向 非 循环 图 (Directed 
Acyclic Graph, DAG) ， 各 个 模块 是 该 图 的 节点 ， 依 赖 关 系 构成 了 有 
问 边 。 这 个 图 不 允许 出 现 循环 ， 因 此 ， 当 出 现 模 块 A 依 赖 于 B， 而 B 又 
依赖 于 A 的 情况 时 ，Maven 就 会 报错 。 


8.6.2 BY KDHE 


一 般 来 说 ， 用 户 会 选择 构建 整个 项 目 或 者 选择 构建 单个 模块 ， 但 
有 些 时 候 ， 用 户 会 想 要 仅仅 构建 完整 反应 堆 中 的 某 些 个 模块 。 换 句 话 
说 ， 用 户 需要 实时 地 裁剪 反应 扒 。 


Maven 提 供 很 多 的 命令 行 选项 支持 裁 六 有 反应堆， 输入 mvn-h 可 以 看 


到 这 些 选 项 : 
-am，--also-make 同 时 构建 所 列 模块 的 依赖 模块 


-amd-also-make-dependents 同 时 构建 依赖 于 所 列 模块 的 模块 


-pl，--projects<arg> 构 建 指 定 的 模块 ， 模 块 间 用 逗号 分 隔 
-If-resume-from<arg> 从 指定 的 模块 回复 反应 堆 


下 面 还 是 以 账户 服务 为 例 (为 合并 聚合 和 继承 ) ， 解 释 这 几 个 选 
项 的 作用 。 上 默认 情况 从 account-aggregator 执 行 mvn clean install 会 得 到 如 
下 完整 的 反应 堆 : 


[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 


Reactor Build Order: 


Account Aggregator 
Account Parent 
Account Email 
Account Persist 


可 以 使 用 -选项 指定 构建 某 几 个 模块 ， 如 运行 如 下 命令 : 


> 


myn clean install -pl account-email,account-persist 


得 到 的 反应 堆 为 : 


[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 
[INFO] 


Reactor Build Order: 


Account Emai 
Account Persist 


使 用 -am 选项 可 以 同时 构建 所 列 模块 的 依赖 模块 。 例 如 ; 


$ mvn clean install -pl account-email-am 


由 于 account-email 依 赖 于 account-parent， 因 此 会 得 到 如 下 反应 堆 : 


[INFO] 
[INFO] 
[INFO 

[INFO] 
[INFO] 


[INFO] 


[INFO] 


Reactor Build Order: 


Account Parent 
Account Email 


使 用 -amd 选 项 可 以 同时 构建 依赖 于 所 列 模块 的 模块 。 例 如 : 


mvn clean install -pl account-parent -amd 


由 于 account-email 和 account-persist 都 依赖 于 account-parent， 因 此 会 
得 到 如 下 反应 堆 : 


[INFO] 一 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Reactor Build Order: 

[INFO 

[INFO] Account Parent 

[INFO] Account Email 

[INFO] Account Persist 

[INFO] 

TIO Yn rn A A Se Re oa 


使 用 -rf 选项 可 以 在 完整 的 反应 堆 构 建 顺序 基础 上 指定 从 哪个 模块 
开始 构建 。 例 如 : 


S$ mvn clean install -rf account-emai 


完整 的 反应 堆 构建 顺序 中 ，account-email 位 于 第 三 ， 它 之 后 只 有 
account-persist， 因 此 会 得 到 如 下 的 裁剪 反应 堆 : 


(INFO) ne ee 
[INFO] Reactor Build Order: 

[INFO] 

[INFO] Account Email 

[INFO] Account Persist 

[INFO] 

(EERE a a a ENE A EEE 


最 后 ， 在 -pl-am 或 者 -pl-amd 的 基础 上 ， 还 能 应 用 -rf 参 数 ， 以 对 裁剪 
后 的 反应 堆 再 次 裁 甬 。 例 如 : 


$ mvn clean install -pl account-parent -amd -rf account-email 


该 命令 中 的 -p1 和 -amd 参 数 会 裁剪 出 一 个 account-parent、account- 
email 和 account-persist 的 反应 堆 ， 在 此 基础 上 ，-r 参 数 指 定 从 account- 
email 参 数 构 建 。 因 此 会 得 到 如 下 的 反应 堆 : 


[RE 
[INFO] Reactor Build Order: 
[INFO] 


在 开发 过 程 中 ， 灵 活 应 用 上 述 4 个 参数 ， 可 以 帮助 我 们 路 过 无 须 构 
建 的 模块 ， 从 而 加 速 构建 。 在 项 目 庞大 、 模 块 特别 多 的 时 候 ， 这 种 效 


果 束 会 异 弟 明显 。 


8.7 7) 


本 章 介绍 并 实现 了 账户 注册 服务 的 第 二 个 模块 account-persist。 基 
于 这 一 模块 和 第 5 章 实现 的 account-email，Maven 的 聚合 特性 得 到 了 介 
绍 和 使 用 ， 从 而 产生 了 account-aggregator 模 块 。 除 了 聚合 之 外 ， 继 承 
也 是 多 模块 项 目 不 可 不 用 的 特性 。account-parent 模 块 伴随 着 继承 的 概 
念 被 一 并 引入 ， 有 了 继承 ， 项 目的 依赖 和 插件 配置 也 得 以 大 幅 优 化 。 


为 了 进一步 消除 读者 可 能 存在 的 混淆 ， 本 革 还 专 | 将 聚合 与 继承 
做 了 详细 比较 。Maven 的 一 大 设计 理念 “约定 优 于 配置 "在 本 章 得 以 前 
述 ， 读 者 甚至 可 以 了 解 到 这 个 概念 是 如 何 通过 超级 POM 的 方式 实现 
的 。 本 章 最 后 介绍 了 多 模块 构建 的 反应 堆 ， 包 括 其 构建 的 顺序 ， 以 及 
可 以 通过 怎样 的 方式 裁 榴 反应 堆 。 


第 9 草 ” 使 用 Nexus 创 建 私 服 


.Nexus 简 介 


.安装 Nexus 


.Nexus 的 仓库 与 仓库 组 


Nexus 的 索引 与 构件 搜索 


:配置 Maven 从 Nexus 下 载 构件 


.部署 构件 至 Nexus 


:Nexus 的 权限 管理 


.Nexus 的 调度 任务 


-其 他 私服 软件 


-小结 


私服 不 是 Maven 的 核心 概念 ， 它 仅仅 是 一 种 衍生 出 来 的 特殊 的 
Maven 仓 库 ， 本 书 已 经 在 6.3.47 解 释 了 其 概念 和 用 途 ， 然 而 这 还 不 


fe o (HII A CAAA, LR DAB IR e e  fap sb 
视 、 加 速 Maven 构 建 、 目 己 部 署 构 件 等 ， 从 而 高 效 地 使 用 Maven e 


有 三 种 专门 的 Maven 仓 库 管 理 软件 可 以 用 来 帮助 大 家 建立 私服 : 
Apache 基 金 会 的 Archiva、JFrog 的 Artifactory 和 Sonatype 的 Nexus。 其 
中 ，Archiva 是 开源 的 ， 而 Artifactory 和 Nexus 的 核心 也 是 开源 的 ， 因 此 
读者 可 以 自由 选择 使 用 。 笔 者 作为 Nexus 开 发 团队 的 成 员 ， 自 然 十 分 
推 染 Nexus。 事 实 上 ，Nexus 也 是 当前 最 流行 的 Maven 仓 库 管 理 软 件 。 


本 章 将 介绍 Nexus 的 主要 功能 ， 并 结合 大 量 图 片 帮助 读者 快速 地 
建立 起 自己 的 Maven 私 服 。 


9.1 Nexus íT 


2005 年 12 月 ，Tamas Cservenak 由 于 受 不 了 匈牙利 电信 ADSL 的 低 
速度 ， 开 始 着 手 开发 Proximity 一 一 一 个 很 简单 的 Web 应 用 。 它 可 以 代 
理 并 缓存 Maven 构 件 ， 当 Maven 需 要 下 载 构件 的 上 时候， 就 不 需要 反复 
依赖 于 ADSL。 到 2007 年 ，Sonatype 邀 请 Tamas 参 与 创建 一 个 更 酷 的 


Maven 仓 库 管理 软件 ， 这 束 是 后 来 的 Nexus 。 


Nexus 团 队 的 成 员 来 自 世界 各 地 ， 它 也 从 社区 收 到 了 大 量 反馈 和 
帮助 ， 在 写本 书 的 时 候 ，Nexus 刚 发 布 1.7.2 版 本 ， 它 也 正 健康 快速 地 
成 长 着 。 


Nexus 分 为 开源 版 和 专业 版 ， 其 中 开源 版 本 基于 GPLv3 许 可 证 ， 其 
特性 足以 满足 大 部 分 Maven 用 户 的 需要 。 以 下 是 一 些 Nexus 开 源 版 本 的 


特性 : 
- 较 小 的 内 存 占 用 (最 少 仅 为 28MB) 
基于 ExtJS 的 友好 界面 
-基于 Restlet 的 完全 REST API 


文 持 代理 仓库 、 和 宿主 仓库 和 仓库 组 


基于 文件 系统 ， 不 需要 数据 库 


文 持 仓库 索引 和 搜索 


文 持 从 界面 上 传 Maven 构 件 


AAA BEA EP il 


Nexus 专 业 版 本 是 需要 付费 购买 的 ， 除 了 开源 版 本 的 所 有 特性 之 
外 ， 它 主要 包含 一 些 企业 安全 控制 、 发 布 流程 控制 等 需要 的 特性 。 感 
兴趣 的 读者 可 以 访问 该 地 址 了 解 详情 : 


http://www.sonatype.com/products/nexus/community ° 


9.2 ”安装 Nexus 


Nexus 是 典型 的 Java Web 应 用 ， 它 有 两 种 安装 包 ， 一 种 是 包含 Jetty 
容 右 的 Bundle 包 ， 另 一 种 是 不 包含 Web 容 器 的 war 包 。 


9.2.1 下载 Nexus 


首先 从 http://nexus.sonatype.org/downloads/ 下 载 最 新 版 本 的 Nexus， 
在 本 书 编写 的 时 候 ，Nexus 的 最 新 版 本 为 1.7.2。 读 者 可 以 根据 需要 下 
载 Bundle 包 nexus-webapp-1.7.2-bundle.tar.gz 和 nexus-webapp-1.7.2- 


bundle.zip ， 或 者 war 包 nexus-webapp-1.7.2.war。 


9.2.2 ”Bundle 方 式 安装 Nexus 


Nexus 的 Bundle 自 带 了 Jetty 容 器 ， 因 此 用 户 不 需要 额外 的 Web 容 器 
就 能 直接 启动 Nexus。 首 先 将 Bundle 文 件 解压 〈 例 如 笔者 将 其 解压 到 
D: \bin\ 目 录 ) ， 这 时 开会 得 到 如 下 两 个 子 目 隶 : 


nexus-webapp-1.7.2/: 该 目 永 包含 了 Nexus 运 行 所 需要 的 文件 ， 如 
启动 脚本 、 依 赖 jar 包 等 。 


-sonatype-work/: 该 目录 包含 Nexus 生 成 的 配置 文件 、 日 志文 件 、 
仓库 文件 等 。 


其 中 ， 第 一 个 目录 是 运行 Nexus 所 必需 的 ， 而 且 所 有 相同 版 本 
Nexus 实 例 所 包含 的 该 日 录 内 容 都 是 一 样 的 。 而 第 二 个 日 隶 不 是 必须 
的 ，Nexus 会 在 运行 的 时 候 动 态 创建 该 目录 ， 不 过 它 的 内 容 对 于 各 个 
Nexus 实 例 十 不 一 样 的 ， 因 为 不 同 用 户 在 不 同 机 右上 使 用 的 Nexus 会 有 
不 同 的 配置 和 仓库 内 容 。 当 用 户 需 要 备份 Nexus 的 时 候 ， 默 认 备 份 
sonatype-work/ 目 录 ， 因 为 该 目录 包含 了 用 户 特 定 的 内 容 ， 而 nexus- 
webapp-1.7.2 目 录 下 的 内 容 是 可 以 从 安装 包 直 接 获 得 的 。 


用 户 只 需要 调用 对 应 操作 系统 的 脚本 就 可 以 启动 Nexus， 这 里 介绍 
主流 的 在 Windows 和 Linux 平 台 上 启动 Nexus 的 方式 。 


在 Windows 操 作 系 统 上 ， 用 户 需 进入 nexus-webppp- 
1.7.2/bin/jsw/windows-x86-32/ 子 目录 ， 然 后 直接 运行 hexus.bat 脚 本 就 能 
启动 Nexus。 如 果 看 到 如 下 输出 ， 束 说 明 启 动 成 功 了 : 


jvm 1 | 2010-09-02 15:27:11 INFO [er_start_runner] -o0.s.n.DefaultNexus - 
Started Nexus (version 1.7.2 OSS) 
jvm 1 |2010-09-02 15:27:11 INFO [er_start_runner] -0.s.n.p.a.DefaultAt ~ 


-Attribute storage directory does not exists, creating it here 

. \.. \Sonatype-work \nexus \proxy \attributes 
jvm 1 | 2010-09-02 15:27:11 WARN [er_start_runner] -o.s.s.m.s.FileModel ~ - 
No configuration file in place, copying the default one andc 
ontinuing with it. 
jvm i | 2010-09-02 15:27:11 INFO [er_start_runner] -0.s.s.m.s.FileModel ~ - 
Loading Security configuration from D: \bin \nexus-oss-webapp-1 
.7.2\. \.. \Sonatype-work \nexus \conf \security. xml 
jvm1 12010-09-02 15:27:11 INFO [er_start_runner] -o.s.s.w.PlexusConfi ~ - 
SecurityManager with role =’org. sonatype. security. PlexusSecuri 
tyManager'and roleHint ='web'found in Plexus. 
jvm 1 | 2010-09-02 15:27:12 INFO [er_start_runner] -org.mortbay.log -Star- 
ted SelectChannelConnector@ 0.0.0.0:8081 


这 时 ， 打 开 浏 览 器 访问 http://localhost: 8081mmexus/ 就 能 看 到 Nexus 
的 界面 ， 如 图 9-1 所 示 。 


z Sonatype Nexus Mave... Ca 

所 © Yr http://localhost:8081/nexus/index.htmil#welcome > Or fF 
一 一 一 一 Log in 
— O 门 ee Sonatype Nexus™ Open Source Edition, Version: 1.7.2 

Sonatype™ Servers 其 

Nexus 

Artifact Search a 


mme == Nexus 


Views/ Repositories a Type in the name of a project, dass, or artifact into the text box below, 


Ri ae and dick Search. Use “Advanced Search* on the left for more options. 
epositories 


Help y £ 


图 9-1 Nexus 的 初始 界面 


要 停止 Nexus， 可 以 在 命令 行 按 Ctrl+C 键 。 


在 nexus-webppp-1.7.2/bin/jsw/windows-x86-32/ 目 孙 下 还 有 其 他 一 些 
脚本 : 


.Installnexus.bat: 将 Nexus 安 装 成 Windows 服 务 。 
‘Uninstallnexus.bat: ##%Nexus Windows 服 务 。 


-Startnexus.bat: 局 动 Nexus Windows 服 务 。 


-Stopnexus.bat: 停止 Nexus Windows 服 务 。 
.Pausenexus.bat: 暂停 Nexus Windows 服 务 。 
.Resumenexus.bat: 恢复 暂停 的 Nexus Windows 服 务 。 


借助 Windows 服 务 ， 用 户 就 可 以 让 Nexus 伴 随 着 Windows 目 动 启 
动 ， 非 常 方便 。 


在 Linux 系 统 上 局 动 Nexus 也 非常 方便 ， 例 如 笔者 使 用 Ubuntu 32 位 
系统 ， 那 么 只 需要 进入 到 nexus-webapp-1.7.2/bin/jsw/linux-x86-32/， 然 


$ . Mexus console 


同样 地 ， 读 者 可 以 看 到 Nexus 启 动 的 命令 行 输出 ， 并 且 可 以 使 用 
Ctrl+C 键 停止 Nexus。 除 了 console 之 外 ，Nexus 的 Linux 脚 本 还 提供 如 下 
的 命令 : 


-/nexus start: 在 后 台 启 动 Nexus 服 务 。 
-/nexus stop: 停止 后 台 的 Nexus 服 务 。 
./nexus status: 查看 后 人 台 Nexus 服 务 的 状态 。 


-/nexus restart: 重新 启动 后 台 的 Nexus 服 务 。 


天 于 Bundle 安 装 的 一 个 常见 问题 是 端口 冲突 。Nexus Bundle 默 认 使 
用 的 端口 是 8081， 如 有 果 该 端口 已 经 被 其 他 应 用 程序 占用 ， 或 者 你 想 使 
用 80 端 口 开放 Nexus 服 务 ， 则 编辑 文件 nexus-webapp- 
1.7.2/conf/plexus.properties， 找 到 属性 application-port， 按 需要 将 默认 值 
8081 改 成 其 他 端口 号 ， 然 后 保存 该 文件 ， 重 局 Nexus 便 可 。 


9.2.3 ”WAR 方式 安装 Nexus 


除了 Bundle，Nexus 还 提供 一 个 可 以 直接 部 署 到 Web 容 器 中 的 war 
包 。 该 war 包 文 持 主流 的 Web 容 器， 如 Tomcat、Glassfish、Jetty 和 


Resin ° 


以 Tomcat 6 为 例 ， 笔 者 在 Vista 机 絮 上 的 目录 为 D: \bin\apache- 
tomcat-6.0.20\， 那 么 只 需要 复制 Nexus war 包 至 Tomcat 的 部 署 目 录 D: 
\bin\apache-tomcat-6.0.20\Wwebapps\nexus.War， 然 后 转 到 D: \bin\apache- 
tomcat-6.0.20\bin\ 目 录 ， 运 行 startup.bat。 这 时 ， 读 者 可 以 从 Tomcat 的 


console 输 出 中 看 到 它 部 署 nexus.war ° 


待 Tomcat 启 动 完 成 后 ， 访 问 http:/Wlocalhost: 8080/nexus/ 就 能 看 到 
Nexus 的 界面 了 。 


9.2.4 ”登录 Nexus 


Nexus 拥 有 全 面 的 权限 控制 功能 ， 默 认 的 Nexus 访 问 都 是 匿名 的 ， 
而 匿名 用 户 仅 包 含 一 些 最 基本 的 权限 ， 要 全 面 学 习 和 管理 Nexus， 就 必 
须 以 管理 员 方式 登录 。 可 以 单 击 界 面 右上 角 的 Log In 进 行 登录 ，Nexus 
的 默认 管理 员 用 户 名 和 密码 为 admin/admin123， 如 图 9-2 所 示 。 


Sonatype 


Sonatype”™ Servers Welcome 
Nexus 


Artifact Scarch 


Views / Repositories 全 Username: admin tinto the text box below 


left for more options. 
Password: 


图 9-2 ”使 用 默认 用 户 名 登录 Nexus 


9.3 ”Nexus 的 仓库 与 仓库 组 


作为 Maven 仓 库 服务 软件 ， 仓 库 目 然 是 Nexus 中 最 重要 的 概念 。 
Nexus 包 含 了 各 种 类 型 的 仓库 概念 ， 包 括 代理 仓库 、 窒 主 仓库 和 仓库 
组 等 。 每 一 种 仓库 都 提供 了 丰富 实用 的 配置 参数 ， 方 便 用 户 根据 需要 


进行 定制 。 


9.3.1 Nexus 内置 的 仓库 


在 具体 介绍 每 一 种 类 型 的 仓库 之 前 ， 先 浏 斋 一 下 Nexus 内 置 的 一 些 
仓库 。 单 击 Nexus 界 面 左边 导航 栏 中 的 Repositories 链 接 ， 就 能 在 界面 右 
边 看 到 如 图 9-3 所 示 的 内 容 。 


这 个 列表 已 经 包含 了 所 有 类 型 的 Nexus 仓 库 。 从 中 可 以 看 到 仓库 有 
四 种 类 型 : group (仓库 组 ) 、hosted (fg) 、proxy (代理 ) 和 
virtual (EWM) 。 每 个 仓库 的 格式 为 maven2 或 者 maven1。 此 外 ， 仓 库 
还 有 一 个 属性 为 Policy RES) ， 表 示 该 仓库 为 发 布 (Release) 版 本 仓 
库 还 是 快照 (Snapshot) 版 本 仓库 。 最 后 两 列 的 值 为 仓库 的 状态 和 路 


(a2 


下面 解释 一 下 各 个 仓库 的 用 途 。 由 于 本 书 不 涉及 Maven 1 的 内 容 ， 
maven1 格 式 的 仓库 会 被 省 略 。 此 外 ， 由 于 虚拟 类 型 仓库 的 作用 实际 上 
征 动 态 地 将 仓库 内 容 格式 转换 ， 换 言 之 也 走 为 了 服务 maven1 格 式 ， 
此 也 被 省 略 。 


Repository « Type Format Repository S Repository Path 

Public Repositories group maven2 http//ocalhost:8031/nexus/content/groups/public 

Public Snapshot Repositories group maven2 tttp://ocalhost:3081/nexus/content/croups/public-snapshots 

3rd party hosted maven2 Release In Service http:/Mocalhost:8081/nexus/content/repositories/thirdparty 

Apache Snapshots proxy maven2 Snapshot in Service http://ocalhost:8081/nexus/content/repositories/apache-snapshot: 
Central M1 shadow virtual maven! Release in Service http:/ocalhost:8081/nexus/content/shadows/centrat-m1 
Codehaus Snapshots proxy maven2 Snapshot in Service http:/Nocalhost:8081/nexus/content/repositories/codehaus-snapsh 
Google Code proxy maven2 Release In Service http://ocalhost:8031/nexus/content/repositories/google 

java.net - Maven 2 proxy maven2 Release In Service http:/localhost:3051/nexus/content/repositories/java.net-m2 


java.net-m1 proxy mavent Release In Service http://ocalhost:8031/nexus/content/repositories/java.net-m1 


java.net-m1 M2 shadow virtual maven2 Release In Service http:/ocaihost 808 1/nexus/content/shadows/java.net-m1-m2 


Maven Central proxy maven2 Release In Service http-/Mocalhost8081/nexus/content/repositories/central 


Releases hosted maven2 Release In Service http-Mocalhost:'8081/nexus/content/repositories/releases 


Snapshots hosted maven2 Snapshot In Service http://ocalhost:3081/nexus/content/repositories/snapshots 


图 9-3 Nexus 内 置 的 仓库 列表 


-Maven Central: 该 仓库 代理 Maven 中 央 人 仓库， 其 策略 为 Release， 
因此 只 会 下 载 和 缓存 中 央 仓 库 中 的 发 布 版 本 构件 。 


‘Releases: 这 是 一 个 策略 为 Release 的 宿主 类 型 仓库 ， 用 来 部 署 组织 
内 部 的 发 布 版 本 构件 。 


.Snapshots: 这 是 一 个 策略 为 Snapshot 的 宿主 类 型 仓库 ， 用 来 部 署 
组 织 内 部 的 快照 版 本 构件 。 


-3rd party: 这 是 一 个 策略 为 Release 的 宿主 类 型 仓库 ， 用 来 部 署 无 
法 从 公共 仓库 获得 的 第 三 方 发 布 版 本 构件 。 


-Apache Snapshots: 这 是 一 个 策略 为 Snapshot 的 代理 仓库 ， 用 来 代 
理 Apache Maven 仓 库 的 快照 版 本 构件 。 


‘Codehaus Snapshots: 这 是 一 个 策略 为 Snapshot 的 代理 仓库 ， 用 来 
代理 Codehaus Maven 仓 库 的 快照 版 本 构件 。 


‘Google Code: 这 是 一 个 策略 为 Release 的 代理 仓库 ， 用 来 代理 
Google Code Maven 仓 库 的 发 布 版 本 构件 。 


java.net-Maven 2: 这 是 一 个 策略 为 Release 的 代理 仓库 ， 用 来 代理 
java.net Maven 仓 库 的 发 布 版 本 构件 。 


‘Public Repositories: 该 仓库 组 将 上 述 所 有 策略 为 Release 的 仓库 聚 
合并 通过 一 致 的 地 址 提供 服务 。 


‘Public Snapshot Repositories: 该 仓库 组 将 上 述 所 有 全 略为 Snapshot 
的 仓库 聚合 并 通过 一 致 的 地 址 提供 服务 。 


举 一 个 简单 的 例子 。 假 设 某 公 司 建 立 了 Maven 项 目 X， 公 司 内 部 建 
立 了 Nexus 私 服 ， 为 所 有 Maven 项 目 提供 服务 。 项 目 X 依 赖 于 很 多 流行 
的 开源 类 库 如 JUnit 等 ， 这 些 构件 都 能 从 Maven 中 央 仓 库 获得 ， 因 此 
Maven Central 代 理 仓 库 会 被 用 来 代理 中 央 仓 库 的 内 容 ， 并 在 私服 上 绥 
存 下 来 ，X 还 依赖 于 某 个 Google Code 的 项 目 ， 其 构件 在 中 央 仓 库 中 不 
存在 ， 只 存在 于 Google Code 的 仓库 中 ， 因 此 上 壕 列 表 中 的 Google Code 
代理 仓库 会 被 用 来 代理 并 缓存 这 样 的 构件 。X 还 依赖 于 Oracle 的 JDBC 张 
动 ， 由 于 版权 的 因素 ， 该 类 库 无 法 从 公共 仓库 获得 ， 因 此 公司 管理 员 
将 其 部 车 到 3rd party 牡 主 仓库 中 ， 供 X 使 用 。X 的 快照 版 本 构件 成 功 


后 ， 会 被 部 署 到 Snapshots 宿 主 仓库 中 ， 供 其 他 项 目 使 用 。 当 X 发 布 正式 
版 本 的 时 候 ， 其 构件 会 被 部 署 到 Release 宿 主 仓库 中 。 由 于 X 用 到 了 上 壕 
列表 中 的 很 多 仓库 ， 为 每 个 仓库 声明 Maven 配 置 又 比较 麻烦 ， 因 此 可 以 
直接 使 用 仓库 组 Public Repositories 和 Public Snapshot Repositories, “4X 

需要 JUnit 的 时 候 ， 它 直接 从 Public Repositories 下 载 ，Public Repositories 


会 选择 Maven Central 提 供 实 际 的 内 容 。 


9.3.2 Nexus 仓库 分 类 的 概念 


为 了 帮助 读者 理解 御 主 仓库 、 代 理 仓库 和 仓库 组 的 概念 ， 图 9-4 用 
更 为 直观 的 方式 展现 了 它们 的 用 途 和 区 别 。 


宿主 仓库 A 


代理 仓库 A 
代理 仓库 B 


图 9-4 & FPR AA Nexus iE 


从 图 9-4 中 可 以 看 到 ，Maven 可 以 直接 从 宿主 仓库 下 载 构件 ; 
Maven 也 可 以 从 代理 仓库 下 载 构件 ， 而 代理 仓库 会 间接 地 从 远程 仓库 下 
载 并 缓存 构件 ; 最 后 ， 为 了 方便 ，Maven 可 以 从 仓库 组 下 载 构件 ， 而 仓 
库 组 没有 实际 内 容 (图 中 用 虚线 表示 ) ， 它 会 转向 其 包含 的 宿主 仓库 
或 者 代理 仓库 获得 实际 构件 的 内 容 。 


9.3.3 创建 Nexus 宿 主 仓 库 


要 创建 一 个 宿主 仓库 ， 首 先 单 击 界面 左边 导航 栏 中 的 Repositories 
链接 ， 在 右边 的 面板 中 ， 选 择 Add， 接 着 在 下 拉 菜 单 中 选择 Hosted 
Repository， 束 会 看 到 图 9-5 所 示 的 配置 界面 。 


New Hosted Repository 

Repository ID 

Repository Name 

Repository Type t 

Provider Maven2 Repository M| € 
Format tà 
Repository Policy Release ~ & 

Default Local Storage Location 


Override Local Storage Location 
a Access Settings 


Deployment Policy Disable Redeploy ~ & 


Allow File Browsing True x| G 
Indude in Search True x: & 
Publish URL True M| @ 


a Expiration Settings 


Not Found Cache TTL 1440 minutes & 


图 9-5 ”创建 Nexus 宿 主 仓库 


根据 自己 的 需要 填 入 仓库 的 ID 和 名 称 ， 下 一 字段 Repository Type 表 
示 该 仓库 的 类 型 。Provider 用 来 确定 该 仓库 的 格式 。 一 般 来 说 ， 选 择 默 
认 的 Maven2 Repository。 然 后 是 Repository Policy， 读 者 可 以 根据 自己 
的 需要 来 配置 该 仓库 是 发 布 版 构件 仓库 还 是 快照 版 构件 仓库 。Default 
Local Storage Location 表 示 该 仓库 的 默认 存储 目录 ， 图 中 该 字段 的 值 为 
空 ， 待 仓库 创建 好 之 后 ， 该 值 就 会 成 为 基于 sonatype-work 的 一 个 文件 
路 径 ， 如 sonatype-work/nexus/storage/repository-id/，Override Local 


Storage Location 可 以 用 来 配置 目 定 义 的 仓库 目 孙 位 置 。 


在 Access Settings 小 组 中 ，Deployment Policy 用 来 配置 该 仓库 的 部 
ARR, AMARE RERE) 、 关 闭 重 新 部 署 (同一 构件 只 能 部 
署 一 次 ) 以 及 人 允许 重新 部 署 。Allow File Browsing 表 示 是 否 允 许 浏 览 
库 内 容 ， 一 般 选 True。 每 个 仓库 (包括 代理 仓库 和 仓库 组 都 有 一 个 
Browse Storage 选 项 卡 ， 用 户 以 树 形 结构 浏览 仓库 存储 文件 的 内 容 ， 如 
图 9-6 所 示 。Include in Search 表 示 是 否 对 该 仓库 进行 索引 并 提供 搜索 ， 
我 们 会 在 9.4 广 详细 讨论 索引 和 搜索 。Publish URL 用 来 控制 是 否 通 过 
URL 提 供 服 务 ， 如 果 选 False， 当 访问 该 仓库 的 地 址 时 ， 会 得 到 HTTP 
404 Not Found 错 误 。 配 置 中 最 后 的 Not Found Cache TTL 表 示 当 一 个 文 
件 没 有 找到 后 ， 缓 存 这 一 不 存在 信息 的 时 间 。 以 默认 值 1440 分 钟 为 
例 ， 如 果 某 文件 不 存在 ， 那 么 在 之 后 的 1440 分 钟 内 ， 如 果 Nexus 再 次 得 
到 该 文件 的 请 求 ， 它 将 直接 返回 不 存在 信息 ， 查找 文件 系统 
这 么 做 是 为 了 避免 重复 的 文件 查找 操作 以 提升 性 能 


Browse Storage | Browse Index 


= Refresh Path Lookup: 
Releases 
国门 index 
@ |.) .meta 
B br 
国 com 
ait 
a (J javax 
3 junit 
(3 junit 
a37 
333.8 
=] junit-3.8 jar 
E] junit-3.8 jar.md5 
= Junit-3.8 jar shat 
= junit-3.8.pom 
=] junit-3.8.pom.md5 
Sj junit-3.8.pom.shat 
(3.8.1 
a (33.8.2 


图 9-6 ”浏览 Nexus 仓 库 内 容 


9.3.4 创建 Nexus 代 理 仓库 


首先 单 击 界面 左边 导航 栏 中 的 Repositories 链 接 ， 在 右边 的 面板 
中 ， 选 择 Add...， 接 着 在 下 朱琳 单 中 选择 Proxy Repository, HAA FIA 
9-7 所 示 的 配置 界面 。 


CENID ` PR ` Provider ` Format ` Policy ` UEH E 
A AAFAA SB ea fe, ON Ato R 
的 是 ， 这 里 的 Repository Type 的 值 为 proxy。 


对 于 代理 仓库 来 说 ， 最 重要 的 是 远程 仓库 的 地 址 ， 即 Remote 
Storage Location， 用 户 必 须 在 这 里 输入 有 效 的 值 。Download Remote 
Indexes 表 示 是 人 否 下 载 远 程 仓库 的 索引 ， 有 些 远程 仓库 拥有 索引 ， 下 载 
其 索引 后 ， 即 使 没有 缓存 远程 仓库 的 构件 ， 用 户 还 是 能 够 在 本 地 搜索 
和 浏览 那些 构件 的 基本 信息 。Checksum Policy 配 置 校 验 和 出 错时 的 策 
略 ， 用 户 可 以 选择 忽略 、 记 录 和 警告 信息 或 者 拒绝 下 载 。 当 远程 仓库 需 
要 认证 的 时 候 ， 这 里 的 Authentication 配 置 就 能 派 上 用 处 。 


New Proxy Repository 
Repository ID 
Repository Name 


Repository Type 好 


Provider Maven2 Repository 


Format 42) 
Repository Policy Release | 6 
Default Local Storage Location 
Override Local Storage Location 
+ Remote Repository Access 
Remote Storage Location http://some-remote-repository/repo-root 
Download Remote Indexes True ~x g 


Checksum Policy Warn x | 各 
[E] Authentication (optional) 


v| Access Settings 


+ Expiration Settings 
Not Found Cache TTL minutes &) 
Artifact Max Age j minutes &» 
Metadata Max Age minutes & 


|| HTTP Request Settings (optional) 


|| Override HTTP Proxy Settings (optional) 


图 9-7 创建 Nexus 代 理 仓 库 


Access Settings 的 配置 与 宿主 仓库 类 似 ， 在 此 不 再 警 述 。Expiration 
Settings E QEZ J Artifact Max Age 和 Metadata Max Age。 其 中 ， 
前 者 表示 构件 缓存 的 最 长 时 间 ， 后 者 表示 仓库 元 数据 文件 缓存 的 最 长 


时 间 。 对 于 发 布 版 仓库 来 说 ，Artifact Max Age 默 认 值 为 -1， 表 示 构 件 
绥 存 后 就 一 直 保 存 着 ， 不 再 重新 下 载 。 对 于 快照 版 仓库 来 说 ，Artifact 
Max Age 鸭 认 值 为 1440 分 钟 ， 表 示 每 隔 一 天 重新 缓存 代理 的 构件 。 


配置 中 最 后 两 项 为 HTTP Request Settings 和 Override HTTP Proxy 
Settings， 其 中 前 者 用 来 配置 Nexus 访 问 远程 仓库 时 HTTP 请 求 的 参数 ， 
后 者 用 来 配置 HTTP 代理 。 


9.3.5 创建 Nexus 仓 库 组 


要 创建 一 个 仓库 组 ， 首 先 单 击 界面 左边 导航 栏 中 的 Repositories 链 
接 ， 在 右边 的 面板 中 ， 选 择 Add， 接 着 在 下 拉 束 单 中 选择 Repository 
Group ， 束 会 看 到 图 9-8 所 示 的 配置 界面 。 


配置 中 的 ID、Name 等 信息 这 里 不 再 费 述 。 需 要 注意 的 是 ， 仓 库 组 
没有 Release 和 Snapshot 的 区 别 ， 这 不 同 于 箱 主 仓库 和 代理 仓库 。 在 配置 
界面 中 ， 用 户 可 以 非常 直观 地 选择 Nexus 中 仓库 ， 将 其 聚合 成 一 个 虚拟 
的 仓库 组 。 注 意 ， 仓 库 组 所 包含 的 仓库 的 顺序 决定 了 仓库 组 遍历 其 所 
含 仓库 的 次 序 ， 因 此 最 好 将 常用 的 仓库 放 在 前 面 ， 当 用 户 从 仓库 组 下 
载 构件 的 时 候 ， 残 能够 尽快 地 访问 到 包 全 构件 的 仓库 。 


New Repository Group 
Group ID 

Group Name 

Provider 

Format 

Publish URL 


=) Maven Central 
Ej 3rd party 
E] Google Code 


Maven2 Repository Group Y 


True vy 


Available Repositories 
图 Apache Snapshots 
=] Codehaus Snapshots 
SJ java.net - Maven 2 
=] java.net-m1 M2 shadow 


=] Releases 
=] Snapshots 


Sj test 


图 9-8 创建 Nexus 仓 库 组 


9.4 Nexus 有 的 索引 | 与 构件 搜索 


既然 Nexus 能 够 维护 宿主 仓库 并 代理 缓存 远程 仓库 (如 Maven 中 央 
E) ， 那 么 一 个 简单 的 需求 就 自然 浮现 出 来 了 ， 这 就 是 搜索 。Maven 中 
央 库 有 几 十 万 构件 供用 户 使 用 ， 但 有 时 我 们 往往 仅仅 知道 某 个 关键 
字 ， 如 Ehcache， 而 不 知道 其 确切 的 Maven 坐 标 。Nexus 通 过 维护 仓库 的 
索引 来 提供 搜索 功能 ， 能 在 很 大 程度 上 方便 Maven 用 户 定 位 构件 坐标 。 


6.8.1 记 介绍 了 Sonatype 提 供 的 在 线 免 费 搜 索 服 务 ， 其 实用 户 可 以 很 
方便 地 自己 维护 一 个 Nexus 实 例 ， 并 提供 搜索 服务 。 


为 了 能 够 搜索 Maven 中 央 库 ， 首 先 需 要 设置 Nexus 中 的 Maven 
Central 代 理 仓库 下 载 远 程 索 引 ， 如 图 9-9 所 示 。 需 要 注意 的 是 ， 黑 认 这 
个 配置 的 值 生 关闭 的 。 此 外 ， 由 于 中 央 库 的 内 容 比较 多 ， 因 此 其 索引 
文件 比较 大 ，Nexus 下 载 该 文件 也 需要 比较 长 的 时 间 ， 读 者 还 需要 耐心 


大 大 /十 
等 待 。 


可 以 想象 到 ，Nexus 在 后 台 运 行 了 一 个 任务 来 下 载 中 央 仓 库 的 索 
引 ， 季 运 的 是 ， 用 户 可 以 通过 界面 直接 观 察 这 一 任务 的 状态 。 单 击 寞 
面 左边 导航 栏 中 的 Scheduled Tasks 链 接 后 ， 用 户 就 能 在 界面 的 右边 看 到 
系统 的 调度 任务 ， 如 采 Nexus 正 在 下 载 中 央 仓 库 的 索引 ， 用 户 避 ® 能 看 到 


图 9-10 所 示 的 一 个 任务 ， 其 状态 为 RUNNING。 在 索引 下 载 完 毕 之 后 ， 
该 任务 就 会 消失 。 


有 了 索引 ， 用 户 即 可 搜索 Maven 构 件 了 。Nexus 界 面 左 边 导 航 栏 有 
一 个 快捷 搜索 框 ， 在 其 中 输入 关键 字 后 ， 单 击 搜索 按钮 就 能 快速 得 到 
搜索 结果 ， 如 图 9-11 所 示 。 
Maven Central proxy maven2 Release In Service 


Releases hosted maven2 Release In Service 


Snapshots hosted maven2 Snapshot In Service 


Browse Index Configuration Mirrors | Summary | Browse Remo 


Repository ID 
Repository Name Maven Central 
Repository Type 
Provider 
Format t 
Repository Policy Release Y & 
Default Local Storage Location 
Override Local Storage Location 

+ Remote Repository Access 

Remote Store 

Download Remote Indexes 


hecksum P 


图 9-9 ”为 Maven Central CEF ALERS FE 


Scheduled Tasks 


= Refresh (J Add © Delete 


Enabled Name « 


true 


Remote URL Changed. 


Type 


Reindex Repositories 


Status 
RUNNING 


Schedule 


internal 


图 9-10 下载 Maven 中 央 仓 库 索 引 的 后 台 任 务 


Sonatype Servers «| | Welcome Search z 
Nexus Keyword Search + | ehcache P 
Group Artifact Version Download 
Shehe ehcache ehcache Latest 1.2.3 (Show All Versions) pom 
‘Advanced Search netsfehcache ehcache Latest: 2.2.0 (Show All Versions) pom 
org.dspace.xmlui.ehcache ehcache Latest 1.1 (Show All Versions) pom, jar 
Views/Repositories i netsfehcache ehcache-site Latest 1.4.0 (Show All Versions) pom, jar 
Repositories netsfehcache ehcache-web-parent Latest 2.0.2 (Show All Versions) pom 
Help mr netsfehcache ehcache-distribution Latest 1.3.0-beta2 (Show All Versions) pom, srczip, bin zip 
netsfehcache ehcache-explicitiocking Latest 0.2 (Show All Versions) pom, jar, javadoc jar, sources jar 
ee bis net sfehcache ehcache-openjpa Latest: 0.2.0 (Show All Versions) pom, jar, javadoc jar, sources jar 
Browse Issue Tracker netsf.ehcache ehcache-nonstopcache Latest: 1.0.0 (Show All Versions) pom, jar, javadocjar, sources jar 
netsfehcache ehcache-unlockedreadsview Latest: 1.0.0 (Show All Versions) pom, jar, javadoc jar, sources jar 
netsf.ehcache ehcache-terracotta-root Latest: 2.1.1 (Show All Versions) pom 
Displaying Top 11 records x Clear Results 


图 9-11 在 Nexus 中 快速 搜索 构件 


该 例 使 用 了 ehcache 关 键 字 进行 搜索 ， 因 此 得 到 了 大 量 与 ehcache 相 
天 的 结果 ， 结 果 中 的 每 一 行 都 表示 了 一 类 构件 ， 信 息 包 括 GroupId ` 
ArtifactId、 最 新 版 本 以 及 最 新 版 本 的 相关 文件 下 载 等 。 单 击 其 中 的 某 


一 行 ， 界 面 的 下 端 会 浮 出 一 个 更 具体 的 构件 信息 面板 ， 如 图 9-12 所 示 。 


esh | Viewing Repository: Central Proxy Maven Information = Artifact Information 


国门 1.6.0-rc1 
aJ 1.6.0-snapshot 
3 部 161 Artifact: ehcache 


z Group: net.sf.ehcache 


ti g1 6.2 Version: 2.2.0 
a 1 7 0 Ext: = pom 
a (gg 1.7.0-beta sian 
a171 , XML: <dependency> 

-172 | <qgroupId>net.sf.ehcache</groupId> 
sth aol ee | <artifactid> Soda <jartifactId> 
Hia 1.8.0 <version>2.2.0</version> 
B (2.0.0 <type>pom< rl 
B 20.1 </dependency> 
H (gg2.1.0 
8 (92.1.1 
Sg 2.2.0 

33 ehcache-2.20.pom 


图 9-12 ”Nexus 的 构件 信息 面板 


该 面板 除了 显示 构件 的 坐标 ， 还 包含 了 一 段 XML 依赖 声明 ， 用 户 
可 以 直接 复制 粘贴 到 项 目的 POM 中 。 此 外 ， 用 户 还 能 从 该 面板 获知 构 
件 在 仓库 中 的 相对 位 置 。 单 击 Artifact Information 还 能 看 到 文件 具体 的 
大 小 、 更 新 时 间 、SHA1 和 MD5 校 疲 和 以 及 下 载 链接 。 除 了 简单 的 关键 
字 搜 索 ，Nexus 还 提供 了 GAV 搜 索 、 类 名 搜索 和 校 答 和 搜索 等 功能 ， 用 
户 可 以 单 击 搜索 页 面 左 上 角 的 下 拉 菜 单 选择 高 级 搜索 功能 


-GAV 搜 索 (GAV Search) 允许 用 户 通 过 设置 GroupId、ArtifactId 和 
Version 等 信息 来 进行 更 有 针对 性 的 搜索 。 


.类 名 搜索 (Classname Search) 人 允许 用 户 搜索 包含 某 个 Java 类 的 构 
件 。 


- 校 验 和 搜索 (Checksum Search) 允许 用 户 直 接 使 用 构件 的 校 验 和 
来 搜索 该 构件 。 


图 9-11 所 示 的 结果 中 包含 了 各 种 坐标 的 结果 。 基 于 该 结果 的 信息 ， 
笔者 进一步 确定 了 自己 需要 的 构件 的 GroupId 和 ArtifactId， 它 们 分 别 为 
net.sf.ehcache 和 ehcache。 这 时 就 可 以 单 击 对 应 的 Show All Versions 转 到 
GAV 搜 索 功 能 来 缩小 搜索 范围 ， 如 图 9-13 所 示 。 


AV Search + Group: netsfehcache Artifact: ehcache Version: 


Group Artifact Version « Download 
netsf.ehcache ehcache 220 pom 
netsfehcache ehcache 21.1 pom 
netsf.ehcache ehcache 2.1.0 

netsfehcache ehcache 2.0.1 

netsf.ehcache ehcache 2.0.0 

netsf.ehcache ehcache 18.0 

netsf.ehcache ehcache 1.72 

netsf.ehcache ehcache 1.7.1 

netsfehcache ehcache 1.7.0-beta pom 

net sf ehcache ehcache 1.7.0 pom 
netsfehcache ehcache 162 pom, javadoc jar, sources jar, jar 


Displaying Top 36 records x Clear Results 


图 9-13 ”在 Nexus 中 使 用 GAV 搜 索 构 件 


当然 ,用户 也 可 以 自己 手动 输入 GroupId、ArtifactId 等 信息 来 进行 
GAV 搜 索 。 


有 了 中 央 仓 库 的 索引 ， 用 户 不 仅 能 够 搜索 构件 ， 还 能 够 直接 浏览 
中 央 仓 库 的 内 容 。 这 便 是 Nexus 的 索引 浏览 功能 。 在 Repositories 页面 
中 ， 选 择 Browse Index 选 项 卡 ， 束 能 看 到 中 央 仓 库 内 容 的 树 形 结构 ， 如 
图 9-14 所 示 。 


Browse Storage Browse Index Configuration Mirrors Summary Browse Remote 


T% Refresh 


3 Maven Central 
+ |__) abbot 
# [_] acegisecurity 
aj‘) activation 
> =) activation 
31.0.2 
=] activation-1.0.2.pom 
d |__} activeciuster 
4 |__) activeio 
3 = activemo 
H |_) activema 
i _] activemg-axis 
4 |_| activema-container 
# |__} activemq-core 


图 9-14 ”Nexus 的 索引 浏览 


以 上 的 搜索 及 浏览 功能 都 是 基于 Nexus 索 引 而 实现 的 ， 确 切 地 应 该 
称 之 为 nexus-indexer。Nexus 能 够 遍历 一 个 Maven 仓 库 所 有 的 内 容 ， 搜 
集 它们 的 坐标 、 校 验 和 及 所 含 的 Java 类 信息 ， 然 后 以 nexus-indexer 的 形 
式 保存 起 来 。 中 央 仓 库 维 护 了 这 样 的 一 个 nexus-indexer， 因 此 本 地 的 
Nexus 下 载 到 这 个 索引 之 后 ， 就 能 在 此 基础 上 提供 搜索 和 浏览 等 服务 。 
需要 注意 的 是 ， 不 是 任何 一 个 公共 仓库 都 提供 nexus-indexer， 对 于 那些 
不 提供 索引 的 仓库 来 说 ， 我 们 束 无 法 对 其 进行 搜索 。 


除了 下 载 使 用 远程 仓库 的 索引 ， 我 们 也 能 为 特 主 仓库 和 代理 仓库 
建立 索引 。 只 需要 在 仓库 上 右 击 ， 从 弹出 的 快捷 菜单 中 选择 ReIndex 即 


可 ， 如 图 9-15 所 示 。 待 索引 编纂 任务 完成 之 后 ， 就 能 搜索 该 仓库 所 包含 
的 构件 。 


Public Repositories group maven2 


Public Snapshot Repositories group maven2 


3rd party ase In Service 
Expire Cache 
Apache Snapshots pshot In Service 


Central M1 shadow ase In Service 


Codehaus Snapshots Incremental ReIndex pshot In Service 
Google Code Rebuild Metadata In Service 


java.net - Maven 2 In Service 
Put Out of Service 


一 m_ mr 和 et - læ Cee See 


图 9-15 “为 Nexus 仓 库 编 纂 索引 


对 于 得主 仓库 来 说 ，ReIndex 任 务 会 扫描 该 仓库 包含 的 所 有 构件 建 
立 索 引 。 对 于 代理 仓库 来 说 ，ReIndex 任 务 会 扫描 所 有 缓存 的 构件 建立 
索引 ， 如 果 远 程 仓库 也 有 索引 ， 则 下 载 后 与 本 地 的 索引 合并 。 对 于 仓 
库 组 来 说 ，ReIndex 任 务 会 合并 其 包含 的 所 有 仓库 的 索引 。 


9.5 配置 Maven 从 Nexus 下 载 构件 


6.4 市 与 7.5.1 节 已 经 详细 介绍 了 如 何在 POM 中 为 Maven 配 置 仓库 和 
插件 仓库 。 例 如 ， 当 需要 为 项 目 添 加 Nexus 私 服 上 的 public 仓 库 上 时， 可 
以 按 代码 清单 9-1 所 示 配 置 。 


代码 清单 9-1 在 POM 中 配置 Nexus 仓 库 


<project > 


<repositories > 
<repository > 
<id>nexus < /id> 
<name >Nexus < /name > 
<url >http://localhost :8081 /nexus /content /groups /public/ < furl > 
<releases > < enabled >true < /enabled > < /releases > 
<snapshots > <enabled >true < /enabled > < /snapshots > 
< /repository > 
< /repositories > 
<pluginRepositories > 
<pluginRepository > 
<id>nexus < /ia > 
<name >Nexus < /name > 
<url >http://localhost :8081 /nexus/content /groups/public/ < /url > 
<releases > <enabled >true< /enabled> < /releases > 
<snapshots > <enabled>true < /enabled > < /snapshots > 
< /pluginRepository > 
< /pluginRepositories > 


< /project > 


这 样 的 配置 只 对 当前 Maven 项 目 有 效 ， 在 实际 应 用 中 ， 我 们 往往 想 
要 通过 一 次 配置 就 能 让 本 机 所 有 的 Maven 项 目 都 使 用 自己 的 Maven 私 
服 。 这 个 时 候 读 者 可 能 会 想到 settings.xml 文 件 ， 该 文件 中 的 配置 对 所 有 
本 机 Maven 项 目 有 效 ， 但 是 settings.xml 并 不 支持 直接 配置 repositories 和 


pluginRepositories ° Pf3#Mavenihfet T Profile#Lii], BELLA PAO 
配置 放 到 setting.xml 中 的 Profile 中 ， 如 代码 清单 9-2 所 示 。 


代码 清单 9-2 ”在 settings.xml 中 配置 Nexus 仓 库 


<settings > 
<profiles > 
<profile> 
<id>nexus < /id> 
< repositories > 
< repository > 
< id >nexus < /id > 


< name > Nexus < /name > 
url >http://localhost:8081 /nexus /content /groups/public/ 
</url> 


<releases > <enabled >true < /enabled> < /releases : 
< snapshots > <enabled>true 


< /enabled > 
< /repository > 


< / snapshots > 
< /repositories > 


<pluginRepositories > 


<pluginRepository > 
<id>nexus < /id> 
<name >Nexus < /name > 
url >http:/ /localhost :8081 /nexus/content /groups /public/ < /url 
<releases > <enabled >true < /enabled> < /releases: 
<snapshots > < 


: enabled >true < /enabled > < /snapshots > 
< /pluginRepository > 
< /pluginRepositories > 

< /profile> 
< /profiles > 
<activeProfiles > 

<activeProfile >nexus < /activeProfile > 
/activeProfiles > 


< /settings > 


该 配置 中 使 用 了 一 个 id 为 nexus 的 profile， 这 个 profile 包 含 了 相关 的 
仓库 配置 ， 同 时 配置 中 又 使 用 activeProfile 元 素 将 nexus 这 个 profile 激 
活 ， 这 样 当 执行 Maven 构 建 的 时 候 ， 激 活 的 profile 会 将 仓库 配置 应 用 到 


项 目 中 去 。 关 于 Maven Profile， 本 书后 面 还 会 有 专门 的 章 一 步 介 


绍 。 


代码 清单 9-2 中 的 配置 已 经 能 让 本 机 所 有 的 Maven 项 目 从 Nexus 私 服 
下 载 构件 。 细 心 的 读者 可 能 会 注意 到 ，Maven 除 了 从 Nexus 下 载 构件 之 
外 ， 还 会 不 时 地 访问 中 央 仓 库 central， 我 们 希望 的 是 所 有 Maven 下 载 请 
求 都 仅仅 通过 Nexus， 以 全 面 发 挥 私服 的 作用 。 这 个 时 候 就 需要 借助 于 
6.7 节 提 到 的 Maven 镜 像 配 置 了 。 可 以 创建 一 个 匹配 任何 仓库 的 镜像 ， 
镜像 的 地 址 为 私服 ， 这 样 ，Maven 对 任何 仓库 的 构件 下 载 请 求 都 会 转 到 
私服 中 。 具 体 配置 见 代 码 清单 9-3。 


代码 清单 9-3 ”配置 镜像 让 Maven 只 使 用 私服 


<settings > 


mirro > 
< mir > 
<l à nexus 1 
rrorof > * 1rroroOt > 
ur mis >http: ocalhost :8081 /nexus /content /groups/public < /url > 

< /mirr 
2 Te rro 
<profile 


< ppo nRepository > 


ie < /enabled > < /releases > 


nots > < e< /enabled > < /snapshots > 
< /P luginRepository > 
/pl ugi Repositories 
/profile> 
< /prof i] es > 


<activeProfiles > 
<activeProfile >nexus < /activeProfile > 
factiveProfiles > 


< /settings > 


关于 镜像 、profile 及 profile 激 活 的 配置 不 再 痪 述 ， 这 里 需要 解释 的 

仓库 及 插件 仓库 配置 ， 它 们 的 id 都 为 central， 也 就 是 说 ， 禾 盖 了 超级 
POM 中 央 仓 库 的 配置 ， 它 们 的 url 已 无 天 紧要 ， 因 为 所 有 请 求 都 会 通过 
镜像 访问 私服 地 址 。 配 置 仓库 及 插件 仓库 的 主要 目的 是 开启 对 快照 版 
本 下 载 的 支持 ， 当 Maven 需 要 下 载 发 布 版 或 快照 版 构件 的 时 候 ， 它 首先 
仿 查 central， 看 该 类 型 的 构件 是 否 文 持 ， 得 到 正面 的 回答 之 后 ， 再 根据 
镜像 匹配 规则 转 而 访问 私服 仓库 地 址 。 


9.6 部署 构件 至 Nexus 


如 果 只 为 代理 外 部 公共 仓库 ， 那 么 Nexus 的 代理 仓库 就 已 经 能 够 
完全 满足 需要 了 。 对 于 男 一 类 Nexus 仓 库 一 一 宿主 仓库 来 说 ， 它 们 的 
主要 作用 是 储存 组 织 内 部 的 ， 或 者 一 些 无 法 从 公共 仓库 中 获得 的 第 二 
方 构 件 ， 供 大 家 下 载 使 用 。 用 户 可 以 配置 Maven 目 动 部 署 构件 至 Nexus 
的 宿主 仓库 ， 也 可 以 通过 界面 手动 上 传 构件 。 


9.6.1 ”使 用 Maven 部 署 构件 至 Nexus 


日 常 开发 生成 的 快照 版 本 构件 可 以 直接 部 署 到 Nexus 中 策略 为 
Snapshot 的 宿主 仓库 中 ， 项 目 正 式 发 布 的 构件 则 应 该 部 署 到 Nexus 中 人 沉 
上 略为 Release 的 答 主 仓库 中 。POM 的 配置 方式 具体 见 5.4 广 ， 代 码 清单 9-4 
列 出 了 一 段 典 型 的 配置 。 


代码 清单 9-4 ”配置 Maven 部 署 构 件 至 Nexus 


< <project > > 


<distributionManagement > 
epository > 
<id>nexus+eleases < /id> 
<name >Nexus Releases Repository < /name > 
url > ht tp:// localhost :8081 /nexus /content /repositories/releases/ < /url > 
< ean tae > 
<snapshotRepository > 
< id >nexus-sSnapshots < /id> 
<name >Nexus Snaps hake Repository < /name > 
<url >http://localhost :8081 /nexus /content /repositories/snapshots/ < /url > 
snapshotRepository > 


< Oo Man agement > 


< /project > 


Nexus 的 仓库 对 于 匿名 用 户 是 只 读 的 。 为 了 能 够 部 署 构件 ， 还 需要 
在 settings.xml 中 配置 认证 信息 ， 如 代码 清单 9-5 所 示 。 


代码 清单 9-5 为 部 署 构 件 至 Nexus 配 置 认证 信息 


<settings > 
<servers > 
<server > 
<id>nexus-releases < /id > 
<username > admin < /username > 
<password > * * * * * < /password > 
< /server > 
<server > 
<id>nexus-snapshots < /id> 
< username > admin < /username > 
<password > * k * * x </password > 
< / server > 
< / servers > 


< /settings > 


9.6.2 “手动 部 署 第 三 方 构件 至 Nexus 


某 些 Java Jar 文 件 (如 Oracle) 的 JDBC 驱 动 ， 由 于 许可 证 的 因素 ， 
它们 无 法 公开 地 放 在 公共 仓库 中 。 此 外 ， 还 有 大 量 的 小 型 开源 项 目 ， 
它们 没有 把 自己 的 构件 分 发 到 中 央 仓 库 中 ， 也 没有 维护 自己 的 仓库 ， 
因此 也 无 法 从 公共 仓库 获得 。 这 个 时 候 用 户 就 需要 将 这 类 构件 手动 下 
载 到 本 地 ， 然 后 通过 Nexus 的 界面 上 传 到 私服 中 。 


要 上 传 第 三 方 构件 ， 首 先 选 择 一 个 答 主 仓库 如 3rd party， 然 后 在 页 
面 的 下 方 选择 Artifact Upload 选 项 卡 。 在 上 传 构 件 的 时 候 ，Nexus 要 求 用 
户 确 定 其 Maven 坐 标 ， 如 果 该 构件 是 通过 Maven 构 建 的 ， 那 么 可 以 在 
GAV Definition 下 拉 列 表 中 选择 From POM， 和 否则 就 选 GAV Parameters ° 
用 户 需 要 为 该 构件 定义 一 个 Maven 坐 标 ， 例 如 上 传 一 个 Oracle 11g 的 
JDBC 驱 动 ， 则 可 以 按 图 9-16 所 示 输 入 坐标 。 


定义 好 坐标 之 后 ， 单 击 Select Artifact (s) to Upload 按 扭 从 本 机 选 
择 要 上 传 的 构件 ， 然 后 单 击 Add Artifact 按 钮 将 其 加 入 到 上 传 列表 中 。 
Nexus 人 允许 用 户 一 次 上 传 一 个 主 构 件 和 多 个 附属 构件 ( 即 Classifier) ° 
最 后 ， 单 击 页 面 最 下 方 的 Upload Artifact (s) 按钮 将 构件 上 传 到 仓库 
-E 


Browse Storage | Browse Index | Configuration | Mirrors | Summary || Artifact Upload 


Select GAV Definition Source 


GAV Definition: GAV Parameters Y & 


Auto Guess: vie 

Sop: com.oracle.driver 
Artifact: jdbc-driver 
Version: lig 

Packaging: 


图 9-16 ”手动 上 传 构件 至 Nexus 


9.7 ” Nexus 的 权限 管理 


在 组 织 中 使 用 Nexus 的 时 候 往往 会 有 一 些 安全 性 需求 ， 例 如 而 望 
只 有 管理 员 才 能 配置 Nexus， 只 有 某 些 团队 成 员 才 能 部 警 构件， 或 者 
更 细 一 些 的 要 求 ， 例 如 每 个 项 目 都 有 目 己 的 Nexus 答 主 仓库 ， 且 只 能 
部 署 项 目 构件 至 该 仓库 中 。Nexus 提 供 了 全 面 的 权限 控制 特性 ， 能 让 
用 户 自由 地 根据 需要 配置 Nexus 用 户 、 角 色 、 权 限 等 。 


9.7.1 Nexus 的 访问 控制 模型 


Nexus 是 基于 权限 (Privilege) 做 访问 控制 的 ， 服 务 器 的 每 一 个 资 
源 都 有 相应 的 权限 来 控制 ， 因 此 用 户 执 行 特 定 的 操作 时 就 必须 拥有 必 
要 的 权限 。 管 理 员 必须 以 角色 (Role) 的 方式 将 权限 赋予 Nexus 用 户 。 
例如 要 访问 Nexus 界 面 ， 就 必须 拥有 Status- (read) 这 个 权限 ， 而 Nexus 
默认 配置 的 角色 UI: Basic UI Privileges 就 包含 了 这 个 权限 ， 再 将 这 个 角 
色 分 配给 某 个 用 户 ， 这 个 用 户 束 能 访问 Nexus 界 面 了 。 


用 户 可 以 被 赋予 一 个 或 者 多 个 角色 ， 角 色 可 以 包 舍 一 个 或 者 多 个 
权限 ， 角 色 还 可 以 包含 一 个 或 者 多 个 其 他 和 角色。 


Nexus 预 定义 了 三 个 用 户 ， 以 admin 登 录 后 ， 单 击 页 面 左 边 导 航 栏 
中 的 User 链 接 ， 就 能 看 到 所 有 已 定义 用 户 的 列表 ， 如 图 9-17 所 示 。 


= Refresh J Add... ~ © Delete All Configured Users + 


User D Realm Name » Email Roles 
admin defaut Administrator changeme@yourcompany.com Nexus Administrator Role 
deployment defaut Deployment User changeme1@yourcompany.com Repo: All Repositories (Full Control), Nexu 


anonymous defaut Nexus Anonynmous User changeme2@yourcompany.com Nexus Anonymous Role, Repo: Al Repos 


图 9-17 Nexus 的 预定 义 用 户 


这 三 个 用 户 对 应 了 三 个 权限 级 别 : 


‘admin: 该 用 户 拥 有 对 Nexus 服 务 的 完全 控制 ， 默 认 密码 为 
admin123 ° 


‘deployment: 该 用 户 能 够 访问 Nexus， 浏 览 仓 库 内 容 ， 搜 索 ， 并 且 
上 传 部 署 构件 ， 但 是 无 法 对 Nexus 进 行 任 何 配置 ， 默 认 密 码 为 
deployment123 ° 


‘anonymous: WAP T PPA ARR A, EA ay AAE 
仓库 并 进行 搜索 。 


在 Users 页 面 中 ， 管 理 员 还 可 以 添加 用 户 。 单 击 上 方 的 Add 按 钮 ， 
选择 Nexus User， 然 后 在 用 户 配 置 面板 中 配置 要 添加 用 户 的 ID、 和 名 称 、 
Email、 状 态 、 密 码 以 及 包含 的 角色 ， 最 后 单 击 Save 按 钮 即 可 。 


可 以 单 击 任何 一 个 用 户 ， 然 后 选择 页 面 下 方 的 Role Tree 选项 卡 ， 
以 树 形 结构 详细 地 查看 该 用 户 所 包含 的 角色 以 及 进一步 的 权限 。 图 9-18 
所 示 是 anonymous 用 户 的 角色 树 。 


Nexus Anonynmous User 
Config Role Tree | Privilege Trace | 


F Refresh 


3- Nexus Anonynmous User 
3 +5) Nexus Anonymous Role 
SJ <> Ul Repository Browser 
=] Read Repository Status 
=] Repositories - (read) 
=] Repository Groups - (read) 
=} Ub Search 
图 Checksum Search 
=] Search Repositories 
=] Artifact Download 
= Repository Content Classes Component - (read) 
=] Repository Types - (read) 
=] Status - (read) 
=] User Forgot Password - (create,read) 
=] User Forgot User id - (create,read) 
3- Repo: All Repositories (Read) 
=] All M1 Repositories - (read) 
=] All M2 Repositories - (read) 
=) All Repositories - (view) 


图 9-18 anonymous 用 户 的 角色 树 


理解 各 个 角色 的 意义 对 于 权限 管理 至 关 重 要 。Nexus 预 定义 的 一 些 
常用 且 重 要 的 角色 包括 : 


‘UI: Basic UI Privileges: 包含 了 访问 Nexus 界 面 必须 的 最 基本 的 权 
限 。 


‘UI: Repository Browser: 包含 了 浏览 仓库 页 面 所 需要 的 权限 。 


-UI: Search: 包含 了 访问 快速 搜索 栏 及 搜索 页 面 所 需要 的 权限 。 


‘Repo: All Repositories (Read) : 给 予 用 户 读 取 所 有 仓库 内 容 的 
权限 ， 没 有 仓库 的 读 权 限 ， 用 户 将 无 法 在 仓库 页 面 上 看 到 实际 的 仓库 
内 容 ， 也 无 法 使 用 Maven 从 仓库 下 载 构件 。 


‘Repo: All Repositories (Full Control) : 给 予 用 户 完 全 控制 所 有 仓 
库 内 容 鸭 权限 。 用 户 不 仅 可 以 浏览 、 下 载 构件 ， 还 可 以 部 署 构件 及 删 
除 仓库 内 容 。 


Nexus 包 人 台 了 一 个 特殊 的 匿名 用 户 角 色 (Nexus Anonymous 
Role) ， 上 默认 配置 下 没有 登录 的 用 户 痢 会 拥有 该 匿名 角色 的 权限 。 这 
个 匿名 用 户 角 色 实 际 包含 了 上 述 所 列 角色 中 ， 除 Repo: All Repositories 
(Full Control) 之 外 的 所 有 角色 所 包含 的 权限 。 也 就 是 说 ， 匿 名 用 户 
可 以 访问 基本 的 Nexus 界 面 、 浏 览 仓库 内 容 及 搜索 构件 。 


除 上 述 角色 之 外 ，Nexus 还 预定 义 了 很 多 其 他 角色 ， 它 们 往往 都 对 
应 了 一 个 Nexus 的 功能 。 例 如 ，UI: Logs and Config Files 包 含 了 访问 系 
统 日 志文 件 及 配置 文件 所 需要 的 权限 。 


9.7.2 ASE op Bch ea Fe 


在 组 织 内 部 ， 如 琳 所 有 项 目 痢 部 署 快 照 及 发 布 版 构件 至 同样 的 仓 
库 ， 束 会 存在 潜在 的 冲突 及 安全 问题 ， 我 们 不 想 让 项 目 A 的 部 署 影响 到 
项 目 B， 反 之 亦 然 。 解 决 的 方法 就 是 为 每 个 项 目 分 配 独 立 的 仓库 ， 并 且 
只 将 仓库 的 部 署 、 修 改 和 删除 权限 赋予 该 项 目的 成 员 ， 其 他 用 户 只 能 
读 取 、 下 载 和 搜索 该 仓库 的 内 容 。 


假设 项 目 名 称 为 foo， 首 移 为 该 项 目 建立 两 个 宿主 仓库 Foo 
Snapshots 和 Foo Releases， 分 别 用 来 部 署 快照 构件 和 发 布 构 件 。 有 具体 步 
又 参见 9.3.3 节 ， 这 里 不 再 芍 述 。 


有 了 仓库 之 后 ， 束 需要 创建 基于 仓库 的 增 、 删 、 改 、 碍 权限 。 在 
Nexus 中 ， dt Target 建 立 的 ，Repository Target 
实际 上 是 一 系列 正则 表达 式 ， 在 访问 仓库 某 路 径 下 内 容 的 时 候 ，Nexus 
Si CFIA EF Repository Target 的 正则 表达 式 一 一 匹配 ， 以 检查 权限 
是 否 正 确 。 


q 


单 击 左 边 导 航 栏 中 的 Repository Targets 链 接 ， 就 能 看 到 图 9-19 所 示 
的 页 面 。 图 中 选中 了 Al (Maven2) 这 一 Repository Target， 在 下 方 可 以 
看 到 它 包 仿 了 一 个 值 为 “.*” 的 正则 表达 式 ， 表 示 该 Repository Target 能 够 
匹配 仓库 下 的 任何 路 径 。 


Targets 

Refresh J Add © Delete 

Name « Repository Type 
All (Maven' maven! 

All (Maven2) maven2 

All but sources (Maven2) maven2 


All Metadata (Maven2) maven2 


Repository Target Configuration 


Name All (Maven2) 


Repository Type maven2 


Pattern Expression: 


Remove All 


图 9-19 Nexus 的 Repository Target 


下 一 步 就 是 基于 该 Repository Target 和 Foo Releases ` Foo Snapshots 
两 个 仓库 建立 权限 。 单 击 页 面 左边 导航 栏 中 的 Privileges 链 接 进 入 权限 
页 面 ， 然 后 单 击 Add 按 钮 ， 选 择 Repository Target Privilege。 图 9-20 所 示 
为 创建 对 应 于 Foo Releases 的 权限 。 


New Repository Target Privilege 


Name Foo Releases 


Description Foo Releases 


Type 
Repository Foo Releases (Repo) 


Repository Target All (Maven2) 


图 9-20 ”为 Foo Releases 创 建仓 库 权 限 


图 9-20 中 选择 了 Foo Releases 仓 库 和 All (Maven2) ， 表 示 创 建 匹 配 
Foo Releases 仓 库 任 何 路 径 的 权限 。 单 击 Save 按 钮 之 后 ， 束 能 在 权限 列 
表 中 看 到 相应 的 增 、 删 、 改 、 查 权限 ， 如 图 9-21 所 示 。 
Foo Releases - (create) Repository Target All (Maven2) Foo Releases 


Foo Releases - (delete) Repository Target All (Maven2) Foo Releases 


Foo Releases - (read) Repository Target All (Maven2) Foo Releases 


Foo Releases - (update) Repository Target All (Maven2) Foo Releases 


图 9-21 Foo Releases 仓 库 的 增 、 删 、 改 、 查 权限 


然后 ， 遵 循 同样 的 步骤 ， 为 Foo Snapshots 建 立 增 、 删 、 改 、 查 权 
BR o 


下 一 步 是 创建 一 个 包含 上 述 权限 的 角色 。 单 击 导 航 栏 中 的 Roles 进 
入 角色 页 面 ， 再 单 击 页面 上 方 的 Add 按 钮 并 选择 Nexus Role。 图 9-22 所 
示 为 将 之 前 建立 的 权限 加 入 到 该 角色 中 。 


Role Id foo-deployer 
Name Foo Deployer 
Description Foo Deployer 


Session Timeout 30 


Selected Roles / Privileges Available Roles / Privileges 
=] Foo Snapshots - (delete) [L] Nexus Administrator Role 
图 Foo Snapshots - (create) _] Nexus Anonymous Role 
=] Foo Snapshots - (read) |__| Nexus Deployment Role 
Œ] Foo Releases - (delete) J Nexus Developer Role 


=] Foo Releases - (update) _] Repo: All Repositories (Full Control) 
=] Foo Releases - (create) _) Repo: All Repositories (Read) 

=] Foo Releases - (read) = „J Uk Base Ul Privileges 

=] Foo Snapshots - (update) _} Ut Group Administration 

„J Uk LDAP Administrator 

Logs and Config Files 


Plugin Console 

Privilege Administration 
Repository Administration 
Repository Browser 

Repository Target Administration 


图 9-22 ”创建 Foo Deployer f 


角色 创建 完成 之 后 ， 根 据 需 要 将 其 分 配给 Foo 项 目的 团队 成 员 。 这 
样 ， 其 他 团队 的 成 员 默 认 只 能 读 取 Foo Releases 和 Foo Snapshots 的 内 
而 拥有 Foo Deployer 角 色 的 用 户 就 可 以 执行 部 署 构件 等 操作 。 


9.8 Nexus 的 调度 任务 


Nexus 提 供 了 一 系列 可 配置 的 调度 任务 来 方便 用 户 管理 系统 。 用 户 
可 以 设 定 这 些 任务 运行 的 方式 ， 例 如 每 天 、 每 周 、 手 动 等 。 调 度 任务 
会 在 适当 的 时 候 在 后 台 运 行 。 当 然 ， 用 户 还 旦 能 够 在 弄 面 观察 它们 的 
状态 的 。 


要 建立 一 个 调度 任务 ， 单 击 左边 导 航 栏 中 的 Scheduled Tasks 链 接 ， 
然后 在 右边 的 界面 上 方 单 击 Add 按 钮 ， 接 着 就 能 看 到 图 9-23 所 示 的 界 
面 。 用 户 可 以 根据 自己 的 需要 ， 选 择 任 务 类 型 ， 并 配置 其 运行 方式 。 


Scheduled Tasks 
T Refresh © Add @ Delete 
Enabled Name « 

New Scheduled Task 


Scheduled Task Configuration 


Enabled JET 


Name rebuild maven metadata 
Task Type 
Download Indexes 
Empty Trash 
Evict Unused Proxied Items From Repository Caches 
Expire Repository Caches 
Publish Indexes 
Alert Email Purge Nexus Timeline 
Recurrence Rebuild Maven Metadata Files 
Reindex Repositories 
Remove Snapshots From Repository 
Schedule Settings Synchronize Shadow Repository 
Without recurrence, this service can only be run manually. 


图 9-23 ”创建 Nexus 调 度 任务 
Nexus 包 含 了 以 下 几 种 类 型 的 调度 任务 : 
‘Download Indexes: 为 代理 仓库 下 载 远程 索引 。 


.Empty Trash: 清空 Nexus 的 回收 站 ， 一 些 操作 (如 删除 仓库 文 
件 ) 实际 是 将 文件 移 到 了 回收 站 中 。 


:Evict Unused Proxied Items From Repository Caches: 删除 代理 仓库 
中 长 期 未 被 使 用 的 构件 缓存 。 


‘Expire Repository Caches: Nexus 为 代理 仓库 维护 了 远程 仓库 的 信 
息 以 避免 不 必要 的 网 络 流量 ， 该 任务 清空 这 些 信 息 以 强制 Nexus 去 重新 
获取 远程 仓库 的 信息 。 


-Publish Indexes: 将 仓库 索引 发 布 成 可 供 m2eclipse 和 其 他 Nexus 使 
用 的 格式 。 


:Purge Nexus Timeline: 删除 Nexus 的 时 间 线 文件 ， 该 文件 用 于 建立 
系统 的 RSS 源 。 


-Rebuild Maven Metadata Files: 基于 仓库 内 容重 新 创建 仓库 元 数据 
文件 maven-metadata.xml， 同 时 重新 创建 每 个 文件 的 校 难 和 md5 和 


shal ° 


.Reindex Repositories: 为 仓库 编纂 索引 。 


-Remove Snapshots From Repository: 以 可 配置 的 方式 删除 仓库 的 
快照 构件 。 


‘Synchronize Shadow Repository: 同步 虚拟 仓库 的 内 容 (服务 于 


Maven1) ° 


9.9 其 他 私服 软件 


Nexus 不 是 唯一 的 Maven 私 服 软件 ， 正 如 本 章 一 开始 所 提 到 的 ， 用 
户 还 有 另外 两 个 选择 ， 它 们 分 别 为 Apache 的 Archiva 与 JFrog 的 


Artifactory ° 


Archiva 可 能 是 历史 最 长 的 Maven 私 服 软件 ， 它 早 在 2005 年 就 作为 
Apache Maven 的 一 个 子 项 目 存 在 ， 到 2008 年 3 月 成 为 了 Apache 软 件 基金 
会 的 顶级 项 目 。 到 本 书 编写 的 时 候 ，Archiva 的 最 新 版 本 为 1.3.1。 


读者 可 以 访问 http:Warchiva.apache.org 以 具体 了 解 Archiva， 其 站 点 
提供 了 一 些 入 门 指南 及 邮件 列表 等 信息 。Archiva 的 下 载 地 址 为 
http://archiva.apache.org/download.html ° 图 9-24 显 示 了 Archiva 的 一 个 仓 
库 管 理 界面 。 


aw Administration - Repositorios 
"a 
archiva nsss. 


7A7 Arhiva Managed internal Nepesitnny 
me.s Hmm 
ee- he * 


nye i 
一 Me ea er 
op wo r 


图 9-24 ”Archiva 的 仓库 管理 界面 


在 Nexus 发 布 之 前 ， 笔 者 曾 一 度 是 Artifactory 的 忠实 用 户 ， 当 时 它 
是 唯一 的 文 持 从 用 户 界面 配置 仓库 的 私服 。Artifactory 的 一 大 特点 是 使 
用 数据 库 来 存储 仓库 内 容 。 读 者 可 以 目 行 访问 JEFrog 站 点 以 了 解 更 多 信 
息 : http://www.jfrog.org/products.php。Artifactory 目 前 的 最 新 版 本 为 
2.2.5， 其 下 载 地 址 为 http://www.jfrog.org/download.php。 图 9-25 所 示 是 
ArtifactoryH) O edt bi Ft Al e 


» @ libs-releases-iocal 
» @ libs-snapshots-ocal 
v @ plugins-reieases-local 
Info 


Name: maven-plugin-anno-1.2.4.p0m 
Size: 670 


Groupld; org./frog. maven.annomojo 
Artifactid: 


Version: 1.2.4 


图 9-25 ArtifactoryH) & eis ot A AL 


ALD AILS AE, Nexush = fia Ate, Archival) EJA 


色 ， 而 Artifactory 的 主 色调 为 绿色 ， 这 或 许 是 各 个 团队 自我 风格 的 一 种 
体现 吧 。 


910 “小 绪 


建立 并 维护 自己 的 私服 是 使 用 Maven 必 不 可 少 的 一 步 ，Maven 私 
服 软 件 有 Nexus、Archiva 和 Artifactory， 它 们 都 提供 了 开源 的 版 本 供用 
户 下 载 。 本 章 详 细 介 绍 了 Nexus 的 安装 和 使 用 ， 包 括 如 何 分 辨 各 种 类 
型 的 仓库 、 如 何 建立 仓库 索引 和 搜索 构件 、 如 何 使 用 权限 管理 功能 、 
如 何 使 用 调度 任务 功能 等 。 除 了 这 些 功 能 之 外 ，Nexus 还 有 很 多 有 趣 
的 特性 ， 如 RSS 源 、 日 志 浏 览 及 配置 等 ， 用 户 可 以 从 友好 的 界面 中 学 
习 使 用 。 


除了 Nexus 本 有 身 ， 本 章 还 详 述 了 如 何 配置 Maven 从 私服 下 载 构件 ， 
以 及 如 何 发 布 构件 至 私服 供 他 人 使 用 。 结 合 了 Nexus 的 帮助 之 后 ， 再 
使 用 Maven 时 束 会 如 虎 添 轰 。 


第 10 章 ”使 用 Maven 进 行 测试 
本 章 内 容 
‘account-captcha 
-‘maven-surefire-plugin fai JT 


- 跳 过 测试 


-动态 指定 要 运行 的 测试 用 例 
包含 与 排除 测试 用 全 
测试 报告 

-运行 TestNG 测 斌 

重用 测试 代码 

小 结 


随 着 敏捷 开发 模式 的 日 益 流 行 ， 软 件 开发 人 员 也 越 来 越 认 识 到 日 
常 编程 工作 中 单元 测试 的 重要 性 。Maven 的 重要 职责 之 一 就 是 自动 运 
行 单元 测试 ， 它 通过 maven-surefire-plugin 与 主流 的 单元 测试 框架 JUnit 
3、JUnit 4 以 及 TestrNG 集 成 ， 并 且 能 够 目 动 生成 丰富 的 结果 报告 。 本 章 


将 介绍 Maven 关 于 测试 的 一 些 重要 特性 ， 但 不 会 深入 解释 单元 测试 框 
架 本 喘 及 相关 技巧 ， 重 点 是 介绍 如 何 通过 Maven 探 制 单元 测试 的 运 


ITS 


除了 测试 之 外 ， 本 章 还 会 进一步 丰富 账户 注册 服务 这 一 背景 案 
例 ， 引 入 其 第 3 个 模块 : account-captcha ° 


10.1 account-captcha 


在 讨论 maven-surefire-plugin 之 前 ， 本 章 先 介绍 实现 账户 注册 服务 
的 account-captcha 模 块 ， 该 模块 负责 处 理 账 户 注册 时 验证 码 的 key 生 
成 、 图 片 生成 以 及 验证 等 。 读 者 可 以 回顾 第 4 革 的 背景 案例 以 获得 更 具 
体 的 需求 信息 。 


10.1.1 account-captchaH‘/POM 


该 模块 的 POM (Project Object Model， 项 目 对 象 模型 ) 还 是 比较 简 
单 的 ， 内 容 见 代码 清单 10-1。 


代码 清单 10-1 account-captcha 的 POM 


< project xmlns = "http:// maven.apache.org/ POM/ 4.0.0" xmlns: xsi = "http:// 
www.w3.org/2001 /XMLSchema-instance" 
xsi: schemaLocation = "http:// maven. apache.org/ POM/ 4.0.0 http:// maven. 
apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < /modelVersion > 
<parent > 
<groupId >com. juvenxu. mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId> 
<version >1.0.0-SNAPSHOT < /version > 
</parent > 


<artifactId >account-captcha < /artifactiId> 
<name >Account Captcha < /name > 


<properties > 
<kaptcha. version >2.3 < /kaptcha. version > 
< /properties > 


< dependencies > 

< dependency > 
<groupId >com. google. code. kaptcha < /groupId > 
<artifactId>kaptcha < /artifactId> 
<version> 5 {kaptcha. version} < /version > 
<classifier >jdki5 </classifier > 

< /dependency > 

< dependency > 
<groupId >org. springframework < /groupId > 


<artifactId >spring-—core < /artifactId > 
< /dependency > 
dependency > 
< groupId >org. springframework < /groupId > 


<artifactIid >spring-beans < /artifactId> 
< /depend jency 
< dependenc} 

< gr yj “Ke > org. springframework < /groupId > 


<art ed eect Id >spring-context < /artifactid> 
/ dependency > 
< dependency > 
<groupId > junit < /groupId > 
<artifactId >junit < /artifactiId> 
< /dependency > 
/ dependencies > 


<repository > 
< fas >sonatype-forge</id> 
<name >Sonatype Forge < /name > 
<url >http:// repository. sonatype.org/ content /groups/ forge/ < /url > 
<releases > 
< enabled >true < /enabled > 
</releases > 
< snapshots > 
<enabled > false < / enabled > 
< / snapshots > 
a ESPOSTE ory > 
</re pos itories > 
< / project 


首先 POM 中 的 第 一 部 分 是 父 模块 声明 ， 如 同 account-email 、 
account-persist 一 样 ， 这 里 将 父 模块 声明 为 account-parent。 紧 接着 是 该 
项 目 本 身 的 artifactId 和 和 名称 ，groupId 和 和 version 没 有 声明 ， 将 自动 继承 自 
父 模块 。 再 往 下 声明 了 一 个 Maven 属 性 kaptcha.version， 该 属性 用 在 依 
赖 声 明 中 ，account-captcha 的 依赖 除了 SpringFramework 和 JUnit 之 外 ， 
还 有 一 个 com.google.code.kaptcha: kaptcha。Kaptcha 是 一 个 用 来 生成 验 
证 码 (Captcha) 的 开源 类 库 ，account-captcha 将 用 它 来 生成 注册 账户 时 
所 需要 的 验证 码 图 片 ， 如 果 想 要 了 解 更 多 关于 Kaptcha 的 信息 ， 可 以 访 
问 其 项 目 主页 : http://code.google.com/p/kaptcha/ ° 


POM 中 SpringFramework 和 JUnit 的 依赖 配置 都 继承 自 父 模块 ， 这 里 
不 再 长 述 。Kaptcha 依 赖 声 明 中 version 使 用 了 Maven 属 性 ， 这 在 之 前 也 
已 经 见 需要 注意 的 是 ，Kaptcha 依 赖 还 有 一 个 classifier 元 素 ， 其 值 
为 jdk5，Kaptcha 针 对 Java 1.5 和 Java 1.4 提 供 了 不 同 的 分 发 包 ， 因 此 这 里 
使 用 classifier 来 区 分 两 个 不 同 的 构件 。 


POM 的 最 后 声明 了 Sonatype Forge 这 一 公共 仓库 ， 这 是 因为 Kaptcha 
并 没有 上 传 的 中 央 仓 库 ， 我 们 可 以 从 Sonatype Forge 仓 库 获 得 该 构件 。 
如 果 有 自己 的 私服 ， 就 不 需要 在 POM 中 声明 该 仓库 了 ， 可 以 代理 
Sonatype Forge 仓 库 ， 或 者 直接 将 Kaptcha 上 传 到 目 己 的 仓库 中 。 


最 后 ， 不 能 忘记 把 account-captcha 加 入 到 限 合 模块 〈 也 是 父 模块 ) 
account-parent 中 ， 见 代码 清单 10-2。 


代码 清单 10-2 ”将 account-captcha 加 入 到 聚合 模块 account-parent 


maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0</r 
<groupId > Com. juvenxu.mvnboo k. account < / groupId > 


delVersion > 


rt ifactid > 


<module > account-email < /module > 
<module >account-persist < /module > 
<module >account-captcha < /module > 
< /modules > 
</project > 


10.1.2 account-captcha 的 主 代 码 


account-captcha 需 要 提供 的 服务 是 生成 随机 的 验证 码 主键 ， 然 后 用 
户 可 以 使 用 这 个 主键 要 求 服务 生成 一 个 验证 码 图 片 ， 这 个 图 片 对 应 的 
值 应 该 是 随机 的 ， 最 后 用 户 用 肉眼 读 取 图 片 的 值 ， 并 将 验证 码 的 主键 
与 这 个 值 交 给 服务 进行 验证 。 这 一 服务 对 应 的 接口 可 以 定义 ， 如 代码 
清单 10-3 所 示 。 


代码 清单 10-3 AccountCaptchaService.java 


package com. juvenxu.mvnbook. account. captcha; 
import java.util.List; 
public interface AccountCaptchaService 


String generateCaptchaKkey () 
throws AccountCaptchaException; 


byte[] generateCaptchalImage ( String captchaKey ) 
throws AccountCaptchaException; 


boolean validateCaptcha( String captchaKey, String captchaValue ) 
throws AccountCaptchaException; 


List <String > getPreDefinedTexts (); 


void setPreDefinedTexts ( List <String > preDefinedTexts ); 


很 显然 ，generateCaptchaKey () 用 来 生成 随机 的 验证 码 主键 ， 
generateCaptchalmage () 用 来 生成 验证 码 图 片 ， 而 validateCaptcha () 
用 来 验证 用 户 反 馈 的 主键 和 值 。 


该 接口 定义 了 额外 的 getPreDefinedTexts () 和 setPreDefinedTexts 
O 方法 ， 通 过 这 一 组 方法 ， 用 户 可 以 预定 义 验证 码 图 片 的 内 容 ， 同 
时 也 提高 了 可 测试 性 。 如 果 AccountCaptchaService 永 远 生 成 随机 的 验证 
码 图 片 ， 那 么 没有 人 工 的 参与 就 很 难 测试 该 功能 。 现 在 ， 服 务 允许 传 
入 一 个 文本 列表 ， 这 样 就 可 以 基于 这 些 文本 生成 验证 码 ， 那 么 我 们 也 
就 能 控制 验证 码 图 片 的 内 容 了 。 


为 了 能 够 生成 随机 的 验证 码 主键 ， 引 入 一 个 RandomGenerator 类 ， 
见 代 码 清 单 10-4。 


代码 清单 10-4 RandomGenerator.java 


package com. juvenxu.mvnbook.account. captcha; 

import java.util.Random; 

public class RandomGenerator 
private static String range = "0123456789abcdefchijkimnoparstuvwxyz"; 
public static synchronized String getRandomString () 
{ 


Random random = new Random(); 


StringBuffer result = new StringBuffer (); 


for (inti = 0; i <8;i1+ +) 
{ 
result. append ( range. charAt ( random. next Int ( range.length() ) ) ); 


return result.toString(); 


RandomGenerator 类 提供 了 一 个 静态 且 线 程 安全 的 getRandomString 
O 方法 。 该 方法 生成 一 个 长 度 为 8 的 字符 串 ， 每 个 字符 都 是 随机 地 从 
所 有 数字 和 字母 中 挑选 ， 这 里 主要 是 使 用 了 java.util.Random 类 ， 其 
nextInt (intn) 方法 会 返回 一 个 大 于 等 于 0 且 小 于 n 的 整数 。 代 码 中 的 字 
段 range 包 含 了 所 有 的 数字 与 字母 ， 将 其 长 度 传 给 nextInt () 方法 后 就 
能 获得 一 个 随机 的 下 标 ， 再 调用 range.charAt () 就 可 以 随机 取得 一 个 
其 包含 的 字符 了 。 


现在 看 AccountCaptchaService 的 实现 类 
AccountCaptchaServiceImpl。 首先 需 要 初始 化 验证 码 图 片 生成 侨 ， 见 代 
码 清 单 10-5。 


代码 清单 10-5 AccountCaptchaServicelmpl.javaHJafterPropertySet 
E 


nport java.awt. image. BufferedImage 
nport java. io.ByteArrayOutputst al 
nport java.io. IOExceptior 
mport java.util. HashMar 
mport java.util. Li 

import java.util.Map 


import javax. imageio. ImagelIO; 


import org. springframework. beans. factory. InitializingBean; 
import com. google. code. kaptcha. impl. DefaultKaptcha; 
import com. TOOTE, i > ants cha.util.Config; 
public class AccountCaptchaServicelImpl 

implements AccountCaptchaService, InitializingBean 


private Default 


Kaptcha producer; 


pub] voida PropertiesSe ) 
throws ceptio 
producer new DefaultKaptcha (); 
C cer fig( new Config( new Properties () ) ); 


AccountCaptchaServiceImpl 实 现 了 SpringFramework 的 
InitializingBean 接 口 ， 该 接口 定义 了 一 个 方法 afterPropertiesSet () ， 该 
方法 会 被 SpringFramework 初 始 化 对 象 的 时 候 调 用 。 该 代码 清单 中 使 用 
该 方法 初始 化 验证 码 生 成 句 producer， 
eo 


并 且 为 producer 提 供 了 默认 的 配 
接着 AccountCaptchaServiceImp] 需 要 实现 generateCaptchaKey () X 
见 代码 清单 10-6。 


代码 清单 10-6 AccountCaptchaServiceImpljava 的 
generateCaptchaKey () 方法 


private Map <String, String> captchaMap = new HashMap <String, String> (); 
private List <String > preDefinedTexts; 
private int textCount 0; 
public String generateCaptchaKey () 
String key = RandomGenerator. getRandomString(); 
String value = getCaptchaText (); 
captchaMap. put ( key, value ); 


return key; 
} 


public List <String > getPreDefinedTexts () 


return preDefinedTexts; 
} 


public void setPreDefinedTexts (List <String > preDefinedTexts ) 


this.preDefinedTexts = preDefinedTexts; 
} 
private String getCaptchaText () 
{ 
if ( preDefinedTexts != null && !preDefinedTexts. isEmpty () ) 
String text = preDefinedTexts. get ( textCount ); 
textCount (textCount +1)% preDefinedTexts.size(); 
return text; 
} 
else 
{ 


return producer. createText (); 


} 


上 述 代 码 清单 中 的 generateCaptchaKey () 首先 生成 一 个 随机 的 验 
证 码 主键 ， 每 个 主键 将 和 一 个 验证 码 字符 串 相关 联 ， 然 后 这 组 关联 会 
被 存储 到 captchaMap 中 以 备 将 来 验证 。 主 键 的 目的 仅仅 是 标识 验证 码 
图 片 ， 其 本 身 没有 实际 的 意义 。 代 码 清单 中 的 getCaptchaText () 用 来 


生成 验证 码 字 符 串 ， 当 preDefinedTexts 不 存在 或 者 为 空 的 时 候 ， 就 是 用 
验证 码 图 片 生成 器 producer 创 建 一 个 随机 的 字符 串 ， 当 preDefinedTexts 
不 为 空 的 时 候 ， 就 顺序 地 循环 该 字符 串 列 表 读 取 值 。preDefinedTexts 有 
其 对 应 的 一 组 get 和 set 方 法 ， 这 样 束 能 让 用 户 预 定义 验证 码 字 符 串 的 

值 。 


有 了 验证 码 图 片 的 主键 ，AccountCaptchaServiceImpl 束 需要 实现 
generateCaptchalmage () 方法 来 生成 验证 码 图 片 ， 见 代码 清单 10-7。 


代码 清单 10-7 AccountCaptchaServiceImpl.java 的 


generateCaptchalmage () 方法 


public byte[] generateCaptchalmage( String captchaKey ) 


throws AccountCaptchaException 


String text captchaMap. get ( captchakey ) ; 
it {tët == Fudd 


throw new AccountCaptchaException ( "Captch key'" + captchaKey + "'not 


found!" 
} 
BufferedImage image = producer.createImage( text }; 
ByteArrayOutputStream out new ByteArrayOutputStream (); 
try 
ImacgelO.write( image, "jpg", out ); 
} 
catch ( IOException e ) 


throw new AccountCaptchaException( "Failed to write captcha stream!", e ); 
} 


return out. toByteArray (); 


K TERRIER, Use te Else ues FR AE, TCS 
单 中 通过 使 用 主键 来 查询 captchaMap 获 得 该 值 ， 如 果 值 不 存在 ， 就 抛 
出 异常 。 有 了 验证 码 字符 串 的 值 之 后 ，generateCaptchaImage () 方法 
就 能 通过 producer 来 生成 一 个 BufferedImage， 随 后 的 代码 将 这 个 图 片 对 
象 转换 成 jpg 格 式 的 字 节 数组 并 返回 。 有 了 该 字 市 数组 ， 用 户 束 能 随意 
地 将 其 保存 成 文件 ， 或 者 在 网 页 上 显示 。 


最 后 是 简单 的 验证 过 程 ， 见 代码 清单 10-8。 


代码 清单 10-8 AccountCaptchaServiceImpl.java 的 validateCaptcha 
no 


public boolean validateCaptcha( String captchaKey, String captchaValue ) 


throws AccountCaptchaException 


String text = captchaMap. get ( captchaKey ); 
1 人 nud 
ire new Ac countCaptchaExcept 1 ( apt k + aptchake ' 
Jund!" ) 
} 
if ext. equals pt lue ) ) 
ptchaMap. re pt ey ) 
turn 1€ 
else 


return false; 


用 户 得 到 了 验证 码 图 乒 以 及 主键 后 ， 吏 会 识别 图 片 中 所 包含 的 字 

符 串 信息 ， 然 后 将 此 验证 码 的 值 与 主键 一 起 反馈 给 validateCaptcha () 

方法 以 进行 验证 。validateCaptcha () 通过 主键 找到 正确 的 验证 码 值 ， 
然后 与 用 户 提供 的 值 进行 比 对 ， 如 果 成 功 ， 则 返回 true 。 


当然 ， 还 需要 一 个 SpringFramework 的 配置 文件 ， 它 在 资源 目录 
src/main/resources/ 下 ， 和 名 为 account-captcha.xml， 见 代码 清单 10-9。 


代码 清单 10-9 account-captcha.xml 


<bean id = “accountCaptchaService" 
class = "com. juvenxu.mvnbook. account. captcha. AccountCaptchaServicelImp1"> 
beans 


这 是 一 个 最 简单 的 SpringFramework 配 置 ， 它 定义 了 一 个 id 为 
accountCaptchaService 的 bean， 其 实现 为 刚才 讨论 的 


AccountCaptchaServiceImpl ° 


10.1.3 ”account-captcha 的 测试 代码 


测试 代码 位 于 src/test/java 目 录 ， 其 包 和 名 也 与 主 代码 一 至， 为 
com.juvenxu.mvnbook.account.captcha。 站 先 看 一 下 简单 的 
RandomeGeneratorTest， 见 代码 清单 10-10。 


代码 清单 10-10 RandomeGeneratorTest.java 


package com. juvenxu.mvnbook. account. captcha; 
import static org. junit.Assert.assertFalse; 


import java.util.HashSet; 
import java.util.Set; 


import org. junit. Test; 
public class RandomGeneratorTest 
@ Test 
public void testGetRandomString () 
throws Exception 
{ 
Set <String > randoms = new HashSet <String>(100 ); 
for (int i= 0; i < 100; i++ ) 
{ 
String random RandomGenerator. getRandomString (); 


assertFalse( randoms. contains (random ) }; 


randoms.add( random ); 


该 测试 用 例 创 建 一 个 初始 容量 为 100 的 集合 randoms， 然 后 循环 100 
次 用 RandomGenerator 生 成 随机 字符 串 并 放 入 randoms 中 ， 同 时 每 次 循环 


都 检查 新 生成 的 随机 值 是 否 已 经 包含 在 集合 中 。 这 样 一 个 人 简单 的 检查 
能 基本 确定 RandomGenerator 生 成 值 是 否 为 随机 的 。 


当然 这 个 模块 中 最 重要 的 测试 应 该 在 AccountCaptchaService 上 ， 见 
代码 清单 10-11。 


代码 清单 10-11 AccountCaptchaServiceTest.java 


package com. juvenxu.mvnbook. account. captcha; 
import static org. junit.Assert. *; 


import java.io.File; 

import java.io. FileOutputStream; 
import java.io. OutputStream; 
import java.util.ArrayList; 
import java.util.List; 


import org. junit.Before; 

import org. junit. Test; 

import org. springframework. context. ApplicationContext; 

import org. springframework, context. support.ClassPathXmlApplicationContext; 


public class AccountCaptchaServiceTest 
{ 
private AccountCaptchaService service; 


@ Before 
public void prepare (} 
throws Exception 
{ 
ApplicationContext ctx = new ClassPathXmlApplicationContext ( "account- 
captcha. xml" ); 
service = (AccountCaptchaService) ctx. getBean{ “accountCaptchaService" ); 
} 


@ Test 

public void testGenerateCaptcha () 
throws Exception 

{ 
String captchaKey = service. generateCaptchaKey (}; 
assertNotNull ( captchaKkey ); 


byte[] captchalImage = service, generateCaptchalmage( captchaKkey }; 
assertTrue( captchaImage. length > 0); 


File image = new File( "target/" + captchaKey + ".jpg" ); 
OutputStream output = null; 
try 
{ 
output = new FileOutputStream( image ); 
output.write( captchalmage ); 


finally 
{ 


if ( output != null ) 


{ 
output.close(); 
} 
J 
} 
assertTrue({ image. exists () && image. length() > 0 ); 
} 
@ Test 


public void testValidateCaptchaCorrect {) 
throws Exception 


List <String > preDefinedTexts = new ArrayList <String>(}; 
preDefinedTexts.add( "12345" ); 

preDefinedTexts.add( "abcde" ); 

service. setPreDefinedTexts ( preDefinedTexts }; 


String captchaKey = service. generateCaptchaKkey (); 
service. generateCaptchalImage ( captchaKey ); 
assertTrue( service. validateCaptcha({ captchaKey, "12345" ) ); 


captchaKkey = service. generateCaptchaKey (); 
service, generateCaptchalImage ( captchaKey ); 
assertTrue( service. validateCaptcha( captchakey, "abcde" ) ); 


+ 


1 
@ Test 
public void testValidateCaptchaIncorrect () 
throws Exception 
List <String > preDefinedTexts = new ArrayList <String > (); 
preDefinedTexts.add( "12345" ); 
service, setPreDefinedTexts ( preDefinedTexts ); 
String captchaKey = service. generateCaptchaKey (); 


service. generateCaptchalImage( captchaKey }; 
assertFalse( service. validateCaptcha( captchaKey, "67890" ) }; 


该 测试 类 的 prepare () 方法 使 用 @Before 标 注 ， 在 运行 每 个 测试 方 
法 之 前 初始 化 AccountCaptchaService 这 个 bean ° 


testGenerateCaptcha () 用 来 测试 验证 码 图 片 的 生成 。 首 先 它 获取 
一 个 验证 码 主 键 并 检查 其 非 空 ， 然 后 使 用 该 主键 获得 验证 码 图 片 ， 


ihe SS PBR, HRAT AWA AES o KREAM 
方法 在 项 目的 target 目 隶 下 创建 一 个 名 为 验证 码 主键 的 jpg 格 式 文件 ， 并 
将 AccountCaptchaService 返 回 的 验证 码 图 片 字 节 数组 内 容 写 入 到 该 jpg 
文件 中 ， 然 后 再 检查 文件 存在 且 包 含 实 际 内 容 。 运 行 该 测试 之 后 ， 就 
能 在 项 目的 target 目 录 下 找到 一 个 名 如 dhb022fc.jpg 的 文件 ， 打 开 是 一 个 
验证 码 图 片 ， 如 图 10-1 所 示 。 


图 10-1 ”AccountCaptchaServiceTest 生 成 的 验证 码 图 片 


testValidateCaptchaCorrect () 用 来 测试 一 个 正确 的 Captcha 验 证 流 
程 。 它 首先 预定 义 了 两 个 Captcha 的 值 放 到 服务 中 ， 然 后 依次 生成 验证 
码 主键 、 验 证 码 图 片 ， 并 且 使 用 主键 和 已 知 的 值 进行 验证 ， 确 保 服 务 
IER Lf ° 


最 后 的 testValidateCaptchaIncorrect () 方法 测试 当 用 户 反馈 的 
Captcha 值 错误 时 发 生 的 情景 ， 它 驳 预 定义 Captcha 的 值 为 "12345”， 但 
最 后 验证 是 传 入 了 “67890”， 并 检查 validateCaptcha () 方法 返回 的 值 为 


false。 


现在 运行 测试 ， 在 项 目 目 录 下 运行 mvn test， 束 会 得 到 如 下 输出 : 


NFO annir JY ojects... 
INFO 
NFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
INFO] Building Account Captcha 1.0.0 - SNAPSHOT 
INFO} 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
INFO] 
INFO] 
LIN FO] —--maven-surefire-plugin:2.4.3:test (default-test) @ account-captcha ——— 
INFO] Surefire report directory: D: \code ch -10 \account-aggregator \account -cap- 


tcha \target \surefire-reports 


Running com. juvenxu.mvnbook. account. capt me: RandomGeneratorTe 
Tests run: 1, Failures: 0, Errors: 0, Ski Spe s , Time El a 0.037 sec 
Running com. juvenxu.mvnbook. account. captcha. AccountCaptchaServiceTest 


Tests run: 3, Failures: 0, Errors:0, Ski) pped: 0, Time elapsed: 1.016 sec 
Results : 


me 


Tests run: 4, Failures: 0, Errors: 0, Skipped: 0 


NRO), Se he ere an SA 
[INFO] BUILD SUCCESS 


[INFO] -----------—------------------------- -__-------------——-------—--——- 


个 简单 的 报告 告诉 我 们 ，Maven 运 行 了 两 个 测试 类 ， 其 中 第 一 个 
测试 类 RandomGeneratorTest 包 含 1 个 测试 ， 第 二 个 测试 类 
AccountCaptchaServiceTest 包 含 3 个 测试 ， 所 有 4 个 测试 运行 完毕 后 ， 没 
有 任何 失败 和 错误 ， 也 没有 跳 过 任何 测试 。 


报告 中 的 Failures、Errors、Skipped 信 息 来 源 于 JUnit 测 试 框架 。 
Failures (失败 ) 表示 要 测试 的 结果 与 预期 值 不 一 致 ， 例 如 测试 代码 期 
望 返回 值 为 tue， 但 实际 为 false; Errors (错误 ) 表示 测试 代码 或 产品 
代码 发 生 了 未 预期 的 错误 ， 例 如 产品 代码 抛 出 了 一 个 空 指 针 错 误 ， 该 
错误 又 没有 被 测试 代码 捕捉 到 ，Skipped 表 示 那 些 被 标记 为 忽略 的 测试 
方法 ， 在 JUnit 中 用 户 可 以 使 用 @Ignore 注 解 标记 忽略 测试 方法 。 


10.2 maven-surefire-plugin{#i JT 


MavenA Ft Rae PS CER, Java tt AEP SE Ay Bc 
试 框架 为 JUnit (http://www.junit.org/) 和 TestNG (http://testng.org/) 
Maven 所 做 的 只 是 在 构建 执行 到 特定 生命 周期 阶段 的 时 候 ， 通 过 插件 
来 执行 JUnit 或 者 TestNG 的 测试 用 例 。 这 一 插件 瓯 是 maven-surefire- 
plugin， 可 以 称 之 为 测试 运行 器 (Test Runner) ， 它 能 很 好 地 兼容 
JUnit 3、JUnit 4 以 及 TestNG 。 


可 以 回顾 一 下 7.2.3 节 介绍 的 default 生 命 周 期 ， 其 中 的 test 阶 段 被 定 
义 为 “使 用 单元 测试 框架 运行 测试 ”。 我 们 知道 ， 生 命 周期 阶段 需要 绑 
定 到 某 个 插件 的 目标 才能 完成 真正 的 工作 ，test 阶 段 正 是 与 mnaven- 
surefire-plugin 的 test 目 标 相 绑 定 了 ， 这 是 一 个 内 置 的 绑 定 ， 具 体 可 参考 


A 


在 默认 情况 下 ，maven-surefire-plugin 的 test 目 标 会 目 动 执行 测试 源 
码 路 径 (默认 为 src/test/java/) 下 所 有 符合 一 组 命名 模式 的 测试 类 。 这 
组 模式 为 : 


“«*/Test* java: 任何 子 目 孙 下 所 有 命名 以 Test 开 头 的 Java 类 。 


**/*Test.java: 任何 子 目录 下 所 有 命名 以 Test 结 尾 的 Java 类 。 


“*/*TestCase java: 任何 子 目录 下 所 有 命名 以 TestCase 结 尾 的 Java 
类 o 


只 要 将 测试 类 按 上 述 模式 命名 ，Maven 束 能 目 动 运 行 它们 ， 用 户 
也 就 不 再 需要 定义 测试 集合 (TestSuite) 来 聚合 测试 用 例 
(TestCase) 。 关 于 模式 需要 注意 的 是 ， 以 Tests 结 尾 的 测试 类 是 不 会 
得 以 目 动 执行 的 。 


当然 ， 如 果 有 需要 ， 可 以 目 己 定义 要 运行 测试 类 的 模式 ， 这 一 
将 在 10.5 节 详细 描述 。 此 外 ， A 
TestNG 测 试 集 合 xml 文 件 ， 这 一 点 将 在 10.7 和 详 述 。 


当然 ， 为 了 能 够 运行 测试 ，Maven 需 要 在 项 目 中 引入 测试 框架 的 
依赖 ， 本 书 已 经 多 次 涉及 了 如 何 添加 JUnit 测 试 范围 依赖 ， 这 里 不 再 痪 
述 ， 而 关于 如 何 引 入 TestNG 依 赖 ， 可 参看 10.7 节 。 


10.3 ”路 过 测试 


日 名 工作 中 ， 软 件 开 发 人 员 总 有 很 多 理由 来 跳 过 单元 测 
试 ,，“ 我 敢 保 证 这 次 改动 不 会 导致 任何 测试 失败 *"，“ 测 试 运行 太 耗 时 
了 ， 暂 时 跳 过 一 下 *,，“ 有 持续 集成 服务 跑 所 有 测试 呢 ， 我 本 地 束 不 执 
行 啦 ”。 在 大 部 分 情况 下 ， 这 些 想法 都 是 不 对 的 ， 任 何 改动 都 要 区 给 测 
试 去 验证 ， 测 试 运行 耗 时 过 长 应 该 考虑 优化 测试 ， 更 不 要 完全 依赖 持 
续集 成 服务 来 报告 锯 误 ， 测 斌 错误 应 该 尽早 在 尽 小 范围 内 发 现 ， 并 太 
时 修复 。 


不 管 怎 样 ， 我 们 总 会 要 求 Maven 跳 过 测试 ， 这 很 简单 ， 在 命令 行 加 
入 参数 skipTests 束 可 以 了 。 例 如 : 


$ mvn package DskipTests 


Maven 输 告诉 你 它 跳 过 了 测试 : 


[INFO] ---maven-compiler-plugin:2.0.2:testCompile (default-testCompile) @ ac- 
count-capte ha 一 一 一 

[INFO] Compili source files to D:\\code \ch -10 \account-aggregator \account- 
captcha aver test- = are sses 

[INFO] 

[INFO] ---—maven-surefire-plugin:2.4.3:test (default-test) @ account-captcha -—— 

[INFO] Tests skipped. 


当然 ， 也 可 以 在 POM 中 配置 maven-surefire-plugin 揪 件 来 提供 该 属 
性 ， 如 代码 清单 10-12 所 示 。 但 这 是 不 推荐 的 做 法 ， 如 果 配 置 POM 让 项 
目 长 时 间 地 跳 过 测试 ， 则 还 要 测试 代码 做 什么 呢 ? 


代码 清单 10-12 ”配置 插件 跳 过 测试 运 


apache. maven. plugins < /groupId > 
surefire-plugin < /artifactId > 


Å : 
<version> < / version > 
<configuration > 
<skipTests >true < /skipTests > 


</configuration > 
</plugin > 


有 时候 用 户 不 仅仅 想 跳 过 测试 运行 ， 还 想 临 时 性 地 跳 过 测试 代码 
的 编译 ，Maven 也 允许 你 这 么 做 ,但 记 住 这 古 不 推荐 的 : 


$ mvn package Dmaven. test. skip =true 


这 时 Maven 的 输出 如 下 : 


[INFO] ---maven-compiler-plugin:2.0.2:testCompile (default-testCompile) @ ac- 
count-captcha -—— 
[INFO] Not compiling test sources 
[INFO] 
[I NFO] ---maven-surefire-plugin:2.4.3:test (default-test) @ account-captcha ——-— 
INFO] Test bd pped. 


参数 maven.test.skip 同 时 控制 了 maven-compiler-plugin 和 maven- 
surefire-plugin 两 个 插件 的 行为 ， 测 试 代码 编译 跳 过 了 ， 测 试 运行 也 跳 
som 


对 应 于 命令 行 参数 maven.test.skip 的 POM 配 置 如 代码 清单 10-13 所 
示 ， 但 这 种 方法 也 是 不 推荐 使 用 的 。 


代码 清单 10-13 ”配置 插件 跳 过 测试 编译 和 运行 


<plugin > 
<groupId >org. apache. maven. plugins < /groupid > 
<artifactId >maven-compiler-plugin < /artifactId> 
<version >2.1</version> 


<configuration > 


<skip >true</skip> 
< /configuration > 
</plugin> 
<plugin> 
<groupId > org. apache. maven ugins < /grouplid> 
<artifactId >maven-suref ert B Ye n</artifactid> 
<version >2.5</version > 
< configuration > 
skip >true</skip> 
< event onfigur ration > 
</plugin > 


实际 上 maven-compiler-plugin 的 testCompile 目 标 和 maven-surefire- 
plugin 的 test 目 标 都 提供 了 一 个 参数 skip 用 来 跳 过 测试 编译 和 测试 运行 ， 
而 这 个 参数 对 应 的 命令 行 表达 式 为 naven.test.skip。 


10.4 动态 指定 要 运行 的 测试 用 例 


有 反复 运行 单个 测试 用 例 是 日 第 开发 中 很 第 见 的 行为 。 例 如 ， 项 目 
代码 中 有 一 个 失败 的 测试 用 例 ， 开 发 人 员 就 会 想 要 再 次 运行 这 个 测试 
以 获得 详细 的 错误 报告 ， 在 修复 该 测试 的 过 程 中 ， 开 发 人 员 也 会 反复 
运行 它 ， 以 确认 修复 代码 是 正确 的 。 如 来 仅仅 为 了 一 个 失败 的 测试 用 
例 而 反复 运行 所 有 测试 ， 未 免 太 浪费 时 间 了 ， 当 项 目 中 测试 的 数目 比 
较 大 的 时 候 ， 这 种 浪费 尤为 明显 。 


maven-surefire-plugin 提 供 了 一 个 test 参 数 让 Maven 用 户 能 够 在 命令 
行 指 定 要 运行 的 测 斌 用例。 例如， 如 果 只 想 运 行 account-captcha 的 
RandomGeneratorTest， 束 可 以 使 用 如 下 命令 : 


$s mvn testDtest = RandomC ‘orTest 


这 里 test 参 数 的 值 是 测试 用 例 的 类 名 ， 这 行 命 令 的 效果 就 是 只 有 


RandomGeneratorTest 这 一 个 测试 类 得 到 运行 


maven-surefire-plugin 的 test 参 数 还 文 持 高 级 一 些 的 赋值 方式 ， 能 让 
用 户 更 灵活 地 指定 需要 运行 的 测试 用 例 。 例 如 : 


mvn test Dtest = Random * Test 


星 号 可 以 匹配 零 个 或 多 个 字符 ， 上 述 命 令 会 运行 项 目 中 所 有 类 名 
以 Random 开 头 、Test 结 尾 的 测试 类 。 

除了 星 号 匹配 ， 还 可 以 使 用 去 号 指定 多 个 测试 用 例 : 

$ mvn test Dtest =RandomGeneratorTest,AccountCaptchaSeryv iceTest 

该 命令 的 test 参 数值 是 两 个 测试 类 名 ， 它 们 之 间 用 逗号 隔 开 ， 其 效 
果 束 是 告诉 Maven 只 运行 这 两 个 测试 类 。 

当然 ， 也 可 以 结合 使 用 星 号 和 逗号 。 例 如: 

$ mvn test Dtest =Random* Test, ,AccountCaptchaServiceTest 

需要 注意 的 是 ， 上 述 几 种 从 命令 行动 态 指定 测试 类 的 方法 都 应 该 
只 是 临时 使 用 ， 如 果 长 时 间 只 运行 项 目的 某 几 个 测试 ， 那 么 测试 束 会 
慢 慢 失去 其 本 来 的 意义 。 


test 参 数 的 值 必 须 匹 配 一 个 或 者 多 个 测试 类 ， 如 果 maven-surefire- 
plugin 找 不 到 任何 匹配 的 测试 类 ， 束 会 报错 并 导致 构建 失败 。 例 如 下 面 
的 命令 没有 匹配 任何 测试 类 : 


这 样 的 命令 会 导致 构建 失败 ， 输 出 如 下 : 


[INFO] ---maven-surefire-plugin:2.4.3:test (default-test) @ account-captcha ——- 


[INFO] Surefire report directory: D: \code `ch -10 \account-aggregator \account-cap- 


tcha \target \surefire-reports 
g r 


TESTS 


There are no tests to run. 


Results : 
Tests run: 0, Failures: 0, Errors: 0, Skipped: 0 


[TPQ] ee ene en emotes een queens 
INFO] BUILD FAILURE 


[INEO] sc a A a 


[INFO] Total time: 1.747s 
[INFO] Finished at: Sun Mar 28 17:00:27 CST 2010 
[INFO] Final Memory: 2M/5M 


[INFO] ---—--——--~-------—------ -—--- +--+ +--+ + + +--+ +--+ --- 


[ERROR] Failed to execute goal org. apache.maven.plugir 
2.4.3:test (default-test) on project account- captcha: No tests were executed! 
(Set-DfaillfNoTests = false to ignore this error.) - > [Help1] 


[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch. 


根据 错误 提示 可 以 加 上 -DfailIfNoTests=false， 告 诉 maven-surefire- 
plugin 即 使 没有 任何 测试 也 不 要 报错 : 


$ mvn test-DtestDfaillfNoTests = false 


a 


这 样 构建 就 能 顺利 执行 完毕 了 。 可 以 发 现 ， 实 际 上 使 用 命令 行 参 
数 -Dtest-DfailIfNoTests=false 是 另外 一 种 跳 过 测试 的 方法 。 


我 们 看 到 ， 使 用 test 参 数 用 户 可 以 从 命令 行 灵 活 地 指定 要 运行 的 测 
斌 类。 可 惜 的 是 ，maven-surefire-plugin 并 没有 提供 任何 参数 文 持 用 户 
从 命令 行 跳 过 指定 的 测试 类 ， 好 在 用 户 可 以 通过 在 POM 中 配置 maven- 


surefire-plugin 排 除 特定 的 测试 类 。 


10.5 包含 与 排除 测试 用 例 


10.2 节 介绍 了 一 组 命名 模式 ， 符 合 这 一 组 模式 的 测试 类 将 会 目 动 执 
行 。Maven 提 倡 约定 优 于 配置 原则 ， 因 此 用 户 应 该 尽量 齐 守 这 一 组 模式 
来 为 测试 类 命名 。 即 便 如 此 ，maven-surefire-plugin 还 是 允许 用 户 通过 
额外 的 配置 来 目 定义 包含 一 些 其 他 测试 类 ， 或 者 排除 一 些 符 合 难 认命 
名 模式 的 测试 类 。 


例如 ， 由 于 历史 原因 ， 有 些 项 目 所 有 测 试 类 名 称 都 以 Tests 结 尾 ， 
这 样 的 名 字 不 符合 默认 的 3 种 模式 ， 因 此 不 会 被 目 动 运行 ， 用 户 可 以 通 
过 代码 清单 10-14 所 示 的 配置 让 Maven 自 动 运行 这 些 测试 。 


代码 清单 10-14” 目 动 运行 以 Tests 结 尾 的 测试 类 


<plugin > 
<groupId >org. apache. maven. plugins < /GroupIGQ > 
<artifactid >maven-surefire-plugin < /artifactId> 
<ver si on > 2 2 < i version > 


< configuration > 
< includes > 
<include > ** / * Tests. java < /include > 
</ includes > 


EIRIS E pE T **/*Tests.java ML 6 Tests Æ Java 
类 ， 两 个 星 号 ** 用 来 匹配 任意 路 径 ， 一 个 星 号 * 匹 配 除 路 径 风 格 符 外 的 


0 个 或 痢 多 个 字符 。 


类 似 地 ， 也 可 以 使 用 excludes 元 又 排除 一 些 符 合 稚 认 命名 模式 的 测 
试 类 ， 如 代码 清单 10-15 所 示 。 


代码 清单 10-15 ”排除 运行 测试 类 


<plugin > 
<groupld >org. apache. maven. plugins < /groupId > 
<artifactId >maven-surefire-plugin< /artifactId > 
<version >2.5</version> 
<configuration > 
< excludes > 
<exclude > ** / * ServiceTest. java < /exclude > 
<exclude > ** /TempDaoTest. java < /exclude > 
</ excludes > 
< / configuration > 


< / plugin > 


EIRE ABER T ATA A ServiceTestt ÆRME, UKTE 
为 TempDaoTest 的 测试 类 。 它 们 都 符合 默认 的 命名 模式 **/*Test.java,， 
不 过 ， 有 了 excludes 配 置 后 ，maven-surefire-plugin 将 不 再 自动 运行 它 
们 。 


10.6 ”测试 报告 


除了 命令 行 输 出 ，Maven 用 户 可 以 使 用 maven-surefire-plugin 等 
件 以 文件 的 形式 生成 更 丰富 的 测试 报告 。 


10.6.1 基本 的 测试 报告 


默认 情况 下 ，maven-surefire-plugin 会 在 项 目的 target/surefire-reports 
目录 下 生成 两 种 格式 的 错误 报告 : 


.简单 文本 格式 
与 JUnit 兼 容 的 XML 格式 


例如 ， 运 行 10.1.3 节 代码 清单 10-10 中 的 RandomGeneratorTest 后 会 得 
到 一 个 名 为 
com.juvenxu.mvnbook.account.captcha.RandomGeneratorTest.txt 的 简单 文 
本 测试 报告 和 一 个 名 为 TEST- 
com.juvenxu.mvnbook.account.captcha.RandomGeneratorTest.xmlHJXML 
测试 报告 。 前 者 的 内 容 十 分 简单 : 
Test set: com: juvenxu.mvnbook.account..captcha:RandomGeneratorTest © 


Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.029 sec 
= r 


这 样 的 报告 对 于 获得 信息 足够 了 ，XML 格 式 的 测试 报告 主要 是 为 
了 支持 工具 的 解析 ， 如 Eclipse 的 JUnit 揪 件 可 以 直接 打开 这 样 的 报告 ， 
如 图 10-2 所 示 。 


Runs: 1/1 Errors: 0 B Failures: 0 


fie) Comjuvenxu.mvnbook.account.captcha.RandomGeneratorTest (0.022 s) 
=) testGetRandomString (0.005 5) 


图 10-2 ”使 用 Eclipse JUnit 持 件 打开 成 功 的 XML 测试 报告 


由 于 这 种 XML 格式 已 经 成 为 了 Java 单 元 测试 报告 的 事实 标准 ， 
些 其 他 工具 也 能 使 用 它们 。 例 如 ， 持 续集 成 服务 右 Hudson 束 能 使 用 这 
样 的 文件 提供 持续 集成 的 测试 报告 。 


以 上 展示 了 一 些 运 行 正 确 的 测试 报告 ， 实 际 上 ， 错 误 的 报告 更 具 
价值 。 我 们 可 以 修改 10.1.3 节 代码 清单 10-11 中 的 
AccountCaptchaServiceTest 计 一 个 测试 失败 ， 这 时 得 到 的 简单 文本 报告 
会 是 这 样 : 


Test set: com. juvenxu. mvnbook. account. captcha. AccountCaptchaServiceTest 
Tests run: 3, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.932 sec < < < 
FAILURE ! 
testValidateCaptchaCorrect (com. juvenxu.mvnbook. account. captcha. AccountCapt- 
chaServiceTest) Time elapsed: 0.047 sec < < < FAILURE! 
java.lang.AssertionError: 

at org. junit.Assert. fail (Assert. java:91) 

at org. junit.Assert.assertTrue (Assert. java:43) 

at org. junit.Assert.assertTrue (Assert. java:54) 


at com. juvenxu. mvnbook. account. captcha. AccountCaptchaServiceTest .testVal- 
idateCaptchaCorrect (AccountCaptchaServiceTest. java:66) 


报告 说 明了 哪个 测试 方法 失败 、 哪 个 断言 失败 以 及 具体 的 堆栈 信 
息 ， 用 户 可 以 据 此 快速 地 寻找 失败 原因 。 该 测试 的 XML 格式 报告 用 
Eclipse JUnit 搬 件 打开 ， 如 图 10-3 所 示 。 


Runs: 3/3 Errors: 0 B Failures: 1 


g com.juvenxu.mvnbook.account.captcha.AccountCaptchaServiceTest (0.929 < 
点 | testGenerateCaptcha (0.838 s) 
| testValidateCaptchaCorrect (0.047 s) 
te) testValidateCaptchalncorrect (0.038 s) 


= Failure Trace 


40 java.lang.AssertionError: 

at com.juvenxu.mvnbook.account.captcha.AccountCaptchaServiceTest.testValidateCa 
at org.apache.maven.surefirejunit4 JUnit4TestSet.execute(JUnit4TestSet.java:62) 

at org.apache.maven.surefire.suite. AbstractDirectoryTestSulte.executeTestSet(Abstra 
at org.apache.maven.surefire.suite AbstractDirectoryTestSuite.execute(AbstractDire 
at org.apache.maven.surefire.Surefire.run(Surefirejava:177) 

at org.apache.maven.surefire.booter.SurefireBooter.runSuitesInProcess(SurefireBoo 
at org.apache.maven.surefire. booter.SurefireBooter.main(SurefireBooter java:1009) 


图 10-3 ”使 用 Eclipse JUnit 揪 件 打开 失败 的 XML 测试 报告 


从 图 10-3 所 示 的 堆栈 信息 中 可 以 看 到 ， 该 测试 是 由 maven-surefire- 
plugin 发 起 的 。 


10.6.2 MRA XIE 


ME m E EE HAMEN EREA EER e 
Cobertura 是 一 个 优秀 的 开源 测试 覆盖 率 统计 工具 〈 详 见 
http://cobertura.sourceforge.net/) ，Maven 通 过 cobertura-maven-plugin 与 
之 集成 ， 用 户 可 以 使 用 简单 的 命令 为 Maven 项 目 生成 测试 履 凑 率 报告 。 
例如 ， 可 以 在 account-captcha 目 录 下 运行 如 下 命令 生成 报告 : 


$ mvn cobertura:cobertura 


接着 打开 项 目 目 录 target/site/cobertura/ 下 的 index.html 文 件 ， 就 能 看 
到 如 图 10-4 所 示 的 测试 履 盖 紊 报告 。 


Coverage Report - com.juvenxu.mvnbook.account.captcha 


Package # Classes Line Coverage Branch Coverage Complexity 
com.juvenxu.mvnbook.account.captcha 4 78% | 36/46 75% | 9/12 Bl 1.333 


Classes in this Package Line Coverage Branch Coverage Complexity 
AccountCaptchaException 0% 


AccountCaptchaService N/A 


AccountCaptchaServiceiImpl 


RandomGenerator 


Report generated by Cobertura 1.9 on 10-3-29 10:02. 


图 10-4 ”Cobertura 测 试 履 盖 认 报告 


单 击 具体 的 类 ， 还 能 看 到 精确 到 行 的 覆盖 率 报告 ， 如 图 10-5 所 示 。 


public bytel] generateCaptchalmage( String captchaKer ) 
throws AccountCaptchaException 
{ 


String text = captchaMap. get( captchaKey ) 


BufferedImage image = producer. cresteImage( tezt ) 
ByteArrerOutputStream out = mew ErteArrarOutputStreen|) 


try 


[ 


ImagelO. write( image, “jpe”, 


图 10-5 ”具体 到 代码 行 的 Cobertura 测 试 履 盖 率 报告 


10.7 运行 TestNG 测 试 


TestNG 是 Java 社 区 中 除 JUnit 之 外 劝 一 个 流行 的 单元 测试 框架 。NG 
是 Next Generation 的 缩写 ， 译 为 * 下 一 代 ”。TestNG 在 JUnit 的 基础 上 增加 
了 很 多 特性 ， 读 者 可 以 访问 其 站 点 http://testng.org/ 获 取 更 多 信息 。 值 得 
一 提 的 是 ， Next Generation Java Testing) (Java 测 试 新 技术 ， 中 文 版 
已 由 机 械 工业 出 版 社 引进 出 版 ， 书 号 为 978-7-111-24550-6) 一 书 专门 介 
绍 TestrNG 和 相关 测试 技巧 。 


使 用 Maven 运 行 TestrNG 十 分 方便 。 以 10.1.3 市 中 的 account-captcha 测 
试 代码 为 例 ， 首 先 需 要 删除 POM 中 的 JUnit 依 赖 ， 加 入 TestNG 依 赖 ， 见 
代码 清单 10-16 ° 


代码 清单 10-16 ”加 入 TestNG 依 赖 


< dependency > 


与 JUnit 类 似 ，TestNG 的 依赖 范围 应 为 test。 此 外 ，TestNG 使 用 
classifier jdk15 和 jdk14 为 不 同 的 Java 平 台 提 供 文 持 。 


步 需 要 将 对 JUnit 的 类 库 引 用 更 改 成 对 TestNG 的 类 库 引 用 。 表 
10-1 给 出 了 常用 类 库 的 对 应 关系 。 


表 10-1 _ JUnit 和 TestNG 的 常用 类 库 对 应 关系 


JUnit 类 TestNG 类 作 用 
org. junit. Test org. testng. annotations. Test 标注 方法 为 测试 方法 
org. junit, Assert org. testng. Assert 仿 查 测试 结果 
org. junit. Before org. testng. annotations. BeforeMethod 标注 方法 在 每 个 测试 方法 之 前 运行 
org. junit. After org. testng. annotations, AfterMethod 标注 方法 在 每 个 测试 方法 之 后 运行 
org, junit. BeforeClass org. testng, annotations. BeforeClass 标注 方法 在 所 有 测试 方法 之 前 运行 
org. junit. AfterClass org. testng. annotations. AfterClass 标注 方法 在 所 有 测试 方法 之 后 运行 


将 JUnit 的 类 库 引 用 改 成 TestNG 之 后 ， 在 命令 行 输入 mvn test, 
Maven 就 会 目 动 运行 那些 符合 命名 模式 的 测试 类 。 这 一 点 与 运行 JUnit 
测试 没有 区 别 。 


TestrNG 人 允许 用 户 使 用 一 个 名 为 testng.xml 的 文件 来 配置 想 要 运行 的 
测试 集合 。 例 如， 可 以 在 account-captcha 的 项 目 根 目录 下 创建 一 个 
testng.xml 文 件 ， 配 置 只 运行 RandomGeneratorTest， 如 代码 清单 10-17 所 


修 ° 


代码 清单 10-17 TestNG 的 testng.xml 


<?xml version encoding = "UTF -8 "? > 

<suite name = "Suitel" verbose ="1"> 

test name = "Regressionl 
<classes > 


ame = "com. juvenxu.mynbook. account 
lasses > 


captcha. RandomGeneratorTest" 


同时 再 配置 maven-surefire-plugin 使 用 该 testng.xml， 如 代码 清单 10- 
18 所 示 。 


代码 清单 10-18 配置 maven-surefire-plugin 使 用 testng.xml 


<plugin > 
<groupId >org. apache. maven. plugins < /GroupIG > 
<artifactId >maven-surefire-plugin < /artifactId > 
<version >2.5</version 
configuration > 
<suitexXmlFiles 
suiteXmlFile >testng.xml < /suiteXmlFile > 
/suiteXmlFiles > 
/ configuration > 
</plugin> 


TestNG 较 JUnit 的 一 大 优势 在 于 它 文 持 测试 组 的 概念 ， 如 下 的 注解 
会 将 测试 方法 加 入 到 两 个 测试 组 util 和 medium 中 : 


@ Test ( groups = { "util", "medium" } ) 


由 于 用 户 可 以 自由 地 标注 方法 所 属 的 测试 组 ， 因 此 这 种 机 制 能 让 
用 户 在 方法 级 别 对 测试 进行 归 类 。 这 


一 后 JUnit 无 法 做 到 ， 它 只 能 实现 
类 级 别 的 测试 归 类 。 


Maven 用 户 可 以 使 用 代码 清单 10-19 所 示 的 配置 运行 一 个 或 者 多 个 
TestNG 测 试 组 。 


代码 清单 10-19 配置 maven-surefire-plugin 运 行 TestNG 测 试 组 


<plugin > 
<groupId >org. apache. maven. plugins < /GroupIG > 


<artifactid >maven-surefire-plugin < /artifactId > 


<version>2.5</version> 
<groups >util,medium< /groups > 


< / configuration > 
</ plugin > 


由 于 篇 幅 所 限 ， 这 里 不 再 介绍 更 多 TestNG 的 测试 技术 ， 感 兴趣 的 
读者 请 访问 TestNG 站 点 。 


10.8 重用 测试 代码 


优秀 的 程序 员 会 像 对 竺 产品 代码 一 样 细心 维护 测 斌 代码， 尤其 是 
那些 供 具体 测试 类 继承 的 抽象 类 ， 它 们 能 够 简化 测试 代码 的 编写 。 还 
有 一 些 根 据 具体 项 目 环境 对 测试 框 染 的 扩展 ， 也 会 被 大 汇 围 地 重用 。 


在 命令 行 运行 mvn package 的 时 候 ，Maven 会 将 项 目的 主 代码 及 资 
源 文件 打包 ， 将 其 安装 或 部 署 到 仓库 之 后 ， 这 些 代 码 就 能 为 他 人 使 
用 ， 从 而 实现 Maven 项 目 级 别 的 重用 。 默 认 的 打包 行为 是 不 会 包含 测 试 
代码 的 ， 因 此 在 使 用 外 部 依赖 的 时 候 ， 其 构件 一 般 都 不 会 包含 测试 代 
码 。 


然后 ， 在 项 目 内 部 重用 某 个 模块 的 测试 代码 是 很 常见 的 需求 ， 可 
能 某 个 底层 模块 的 测试 代码 中 包含 了 一 些 常用 的 测试 工具 类 ， 或 者 一 
些 高 质量 的 测试 基 类 供 继承 。 这 个 时 候 Maven 用 户 就 需要 通过 配置 
maven-jar-plugin 将 测试 类 打包 ， 如 代码 清单 10-20 所 示 。 


代码 清单 10-20 ”打包 测试 代码 


<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-jar-plugin< /artifactId> 
<version >2.2 </version > 
<executions > 
< execution > 
< goals > 
<goal >test-jar < /goal> 
/ goals > 
< / execution > 
< / executions > 
</plugin> 


maven-jar-plugin 有 两 个 目标 ， 分 别 是 jar 和 test-jar， 前 者 通过 Maven 
的 内 置 绑 定 在 default 生 命 周 期 的 package 阶 段 运行 ， 其 行为 就 是 对 项 目 
主 代 码 进行 打包 ， 而 后 者 并 没有 内 置 绑 定 ， 因 此 上 述 的 插件 配置 显 式 
声明 该 目标 来 打包 测试 代码 。 通 过 得 询 该 插件 的 具体 信息 可 以 了 解 
到 ，test-jar 的 默认 绑 定 生命 周期 阶段 为 package， 因 此 当 运 行 mvn clean 
package 后 就 会 看 到 如 下 输出 : 


[INFO] ---maven-jar-plugin:2.2:jar EA jar) @ account-captcha 一 一 一 
[INFO] Building jar: D: \code\ch—-10 \account-aggregator \account-captcha \target \ 
account-captcha -1.0.0 - SNAPSHOT. jar 


INFO] 
[INFO] ---maven-jar-plugin:2.2:test-jar (default) @ account-captcha -—- 


[INFO] Building jar: D: \c sede \ch -10 \account-aggregator \account-captcha \target \ 
account—-captcha -1.0.0 -SNAPSHOT —tests. jar 


maven-jarplugin 的 两 个 目标 都 得 以 执行 ， 分 别 打包 了 项 目 主 代码 
和 测试 代码 。 


现在 ， 就 可 以 通过 依赖 声明 使 用 这 样 的 测试 包 构 件 了 ， 如 代码 清 
单 10-21 所 示 。 


代码 清单 10-21 依赖 测试 包 构 件 


< dependency > 
<groupId >com, juvenxu. mvnbook. account < /groupId > 


<artifactId >account-captcha < /artifactId> 
< version <A. ‘ 0 .0 — SNAPSHOT < version > 
<type >test-jar < / type > 

ope >test < /scope > 


< /dependen 


上 上 述 依 赖 声 明 中 有 一 个 特殊 的 元 素 type， 所 有 测试 包 构 件 痢 使 用 特 
殊 的 test-jar 打 包 类 型 。 需 要 注意 的 是 ， 这 一 类 型 的 依赖 同样 都 使 用 test 
依赖 范围 。 


10.9 小结 


本 章 的 主题 是 Maven 与 测试 的 集成 ， 不 过 在 讲述 具体 的 测试 技巧 
之 前 先 实 现 了 背景 案例 的 account-captcha 模 块 ， 这 一 模块 的 测试 代码 也 
成 了 本 章 其 他 内 容 良 好 的 素材 。maven-surefire-plugin 是 Maven 背 后 真 
正 执行 测试 的 插件 ， 它 有 一 组 默认 的 文件 名 模式 来 匹配 并 目 动 运行 测 
斌 类。 用 户 还 可 以 使 用 该 插件 来 跳 过 测试 、 动 态 执 行 测试 类 、 包 含 或 
排除 测试 等 。maven-surefire-plugin 能 生成 基本 的 测试 报告 ， 除 此 之 外 
还 能 使 用 cobertura-maven-plugin 生 成 测试 覆盖 率 报告 。 


除了 主流 的 JUnit 之 外 ， 本 章 还 讲述 了 如 何 与 TestNG 集 成 ， 最 后 介 
绍 了 如 何 重 用 测试 代码 。 


第 11 章 ”使 用 Hudson 进 行 持续 集成 

本 章 内 容 

:持续 集成 的 作用 、 过 程 和 优势 

Hudson 简介 

.安装 Hudson 

.准备 Subversion 仓 库 

Hudson 的 基本 系统 设置 

:创建 Hudson 任 务 

监视 Hudson 任 务 状态 

.Hudson 用 户 管理 

-邮件 反馈 

.Hudson 工 作 目录 


-小结 


作为 最 核心 的 敏捷 实践 之 一 一 一 持续 集成 (Continuous 

Integration) 越 来 越 受到 广大 开发 人 员 的 喜爱 和 推 索 。 借 助 前 文 讲述 的 
Maven 所 实现 的 目 动 化 构建 正 是 持续 集成 的 一 个 必要 前 所， 持续 集成 
还 要 求 开 发 人 员 使 用 版 本 控制 工具 和 持续 集成 服务 器 。 例 如 Subversion 
束 是 当前 最 流行 的 版 本 控制 工具 ， 而 Hudson 则 是 最 流行 的 开源 持续 集 
成 服务 絮 软 件 。 本 草 将 简要 介绍 持续 集成 的 概念 和 Subversion 的 基本 使 
用 ， 主 要 关注 如 何 使 用 Hudson， 尤 其 是 如 何 结合 Maven 与 Hudson 持 续 
集成 我 们 的 项 目 。 


11.1 持续 集成 的 作用 、 过 程 和 优势 


简单 地 说 ， 持 续集 成 就 是 快速 且 高 频率 地 目 动 构建 项 目的 所 有 源 
码 ， 并 为 项 目 成 员 提供 丰富 的 反馈 信息 。 这 句 话 有 很 多 关键 的 词 : 


‘TRUE: 集成 的 速度 要 尽 可 能 地 快 ， 开 发 人 员 不 希望 目 己 的 代码 提 
交 半 天 之 后 才 得 到 反馈 。 

-高 频率 :频率 越 高 越 好 ， 例 如 每 隔 一 小 时 就 是 个 不 错 的 选择 ， 这 
样 问题 才能 尽早 地 被 反映 出 来 。 


AD): 持续 集成 应 该 是 目 动 触发 并 执行 的 ， 不 应 该 有 手工 参与 。 
构建: 包括 编译 、 测 试 、 审 碍 、 打 包 、 部署 等 工作 。 
-所 有 源码 : 所 有 团队 成 员 提 交 到 代码 库 里 的 最 新 的 源 代 人 码 。 


反馈 : 持续 集成 应 该 通过 各 种 快捷 的 方式 告诉 团队 成 员 最 新 的 集 
成 状态 ， 当 集成 失败 的 时 候 ， 反 馈 报 告 应 该 尽 可 能 地 反映 失败 的 具体 
细节 。 

一 个 典型 的 持续 集成 场景 是 这 样 的 ， 开 发 人 员 对 代码 做 了 一 些 修 


改 ， 在 本 地 运行 构建 并 确认 无 误 之 后 ， 将 更 改 提交 到 代码 库 。 具 有 高 
配置 硬件 的 持续 集成 服务 器 每 隔 30 分 钟 查询 代码 库 一 次 ， 发 现 更 新 之 


后 ， 签 出 所 有 最 新 的 源 代码 ， 然 后 调用 自动 化 构建 工具 (如 Maven) 构 
建 项 目 ， 该 过 程 包括 编译 、 测 试 、 审 查 、 打 包 和 部 署 等 。 然 而 不 幸 的 
是 ， 男 外 一 名 开发 人 员 在 这 一 时 间 段 也 提交 了 代码 更 改 ， 两 处 更 改 导 
致 了 某 些 测试 的 失败 ， 持 续集 成 服务 器 基于 这 些 失 败 的 测试 创建 一 个 
报告 ， 并 自动 发 送 给 相关 开发 人 员 。 开 发 人 员 收 到 报告 后 ， 立 即 着 手 
调查 原因 ， 并 尽快 修复 。 


图 11-1 形 象 地 展示 了 整个 持续 集成 的 过 程 。 


通过 图 11-1 可 知 ， 当 持续 集成 服务 器 构建 项 目 成 功 后 ， 还 可 以 自动 
将 项 目 构 件 部 署 到 Nexus 私 服 中 。 


一 次 完整 的 集成 往往 会 包括 以 下 6 个 步 桑 : 


1) 持续 编译 ， 所 有 正式 的 源 代码 都 应 该 提交 到 源码 控制 系统 
(如 Subversion) ， 持 续集 成 服务 器 按 一 定 频 率 检 查 源 码 控制 系统 ， 如 
果 有 新 的 代码 ， 就 触发 一 次 集成 ， 旧 的 已 编译 的 字 节 码 应 当 全 部 清 
除 ， 然 后 服务 器 编译 所 有 最 新 的 源码 。 


2) 持续 数据 库 集 成 : 在 很 多 项 目 中 ， 源 代码 不 仅仅 指 Java 代 码 ， 
还 包括 了 数据 库 SQL 脚 本， 如 有 果 单 独 管理 它们 ， 很 容易 造成 与 项 目 其 
他 代码 的 不 一 致 ， 并 造成 混乱 。 插 续集 成 也 应 该 包括 数据 库 的 集成 ， 
每 次 发 现 新 的 SQL 脚本 ， 就 应 该 清理 集成 环境 的 数据 库 ， 重 新 创建 表 


结构 ， 并 填 入 预备 的 数据 。 这 样 束 能 随时 发 现 脚 本 的 错误 ， 此 外 ， 基 
于 这 些 脚 本 的 测试 还 能 进一步 发 现 其 他 相关 的 问题 。 
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图 11-1 持续 集成 流程 


3) 持续 测试 ， 有 了 JUnit 之 类 的 框架 ， 目 动 化 测试 就 成 了 可 能 。 编 
写 优 民 的 单元 测试 并 不 容易 ， 好 的 单元 测试 必须 是 目 动 化 的 、 可 重复 
执行 的 、 不 依赖 于 环境 的 ， 并 且 能 够 目 我 检查 的 。 除 了 单元 测试 ， 有 
些 项 目 还 会 包含 一 些 依赖 外 部 环境 的 集成 测试 。 所 有 这 些 测试 都 应 该 
在 每 次 集成 的 时 候 运 行 ， 并 且 在 发 生 问 题 的 时 候 能 产生 具体 报告 。 


A) 持续 审查 : 诸如 Checkstyle 和 PMD 之 类 的 工具 能 够 帮 有 我 们 发 现 
代码 中 的 坏 味道 (Bad Smell) ， 持 续集 成 可 以 使 用 这 些 工 具 来 生成 各 
类 报告 ， 如 测试 覆盖 率 报告 、Checkstyle 报 告 、PMD 报 告 等 。 这 些 报告 


的 生成 频率 可 以 低 一 些 ， 如 每 日 生成 一 次 ， 当 审查 发 现 问题 的 时 候 ， 
ALE ACA ci ate 


5) 持续 部 署 ， 有些 错误 只 有 在 部 署 后 才能 被 发 现 ， 它 们 往往 是 具 
体 容 天 或 者 环境 相关 的 ， 目 动 化 部 署 能 够 帮助 我 们 尽快 发 现 这 类 问 


题 。 


pang 


6) FEMI: 持续 集成 的 最 后 一 步 的 反馈 ， 通 第 是 一 封 电 子 邮 
件 。 在 重要 的 时 候 将 正确 的 信息 发 送 给 正确 鸭 人 。 如 打开 发 者 一 直 受 
到 与 目 己 无 天 的 持续 集成 报告 ， 他 慢 慢 地 束 会 忽略 这 些 报告 。 基 本 的 
规则 是 ， 将 集成 失败 报告 发 送 给 这 次 集成 相关 的 代码 提交 钴 ， 项 目 经 
理应 该 收 到 所 有 失败 报告 。 


持续 集成 需要 引入 额外 的 硬件 设置 ， 特 别 是 对 于 持续 集成 服务 器 
来 说 ， 性 能 越 高 ， 集 成 的 速度 就 越 快 ， 反 馈 的 速度 也 就 越 快 。 持 续集 
成 还 要 求 开 发 者 使 用 各 种 工具 ， 如 源码 控制 工具 、 目 动 化 构建 工具 
目 动 化 测试 工具 、 持 续集 成 软件 等 。 这 一 切 无 疑 都 增加 了 开发 人 员 的 
负担， 然而 学 习 并 适应 这 些 工具 及 流程 是 完全 值得 的 ， 因 为 持续 集成 
有 看 很 多 好 处 : 


-尽早 雄 露 问题 ， 越 早 地 又 露 问题 ， 修 复 问 题 代码 的 成 本 束 越 低 。 
持续 集成 高 频率 地 编译 、 测 试 、 审 碍 、 部 署 项 目 代码 ， 能 够 快速 地 发 
现 问 题 并 及 时 反馈 。 


-减少 重复 操作 ， 持 续集 成 是 完全 目 动 化 的 ， 这 束 避 免 了 大 量 重复 
的 手工 劳动 ， 开 发 人 员 不 再 需要 手动 地 去 签 出 源码 ， 一 步 步 地 编译 、 
M EE ` ME 

-简化 项 目 发 布 : 每 日 高 频率 的 集成 保证 了 项 目 随时 都 是 可 以 部 署 
行 的 ， 如 末 没 有 持续 集成 ， 项 目 发 布 之 前 将 不 得 不 手动 地 集成 ， 然 


运行 
后 伦 大 量 精力 修复 集成 问题 。 


-建立 团队 信心 :一 个 优 民 的 持续 集成 环境 能 让 团队 随时 对 项 目的 
状态 保持 信心 ， 因 为 项 目的 大 部 分 问题 区 域 已 经 由 持续 集成 环境 覆盖 
ye 


既然 持续 集成 有 那么 多 优点 ， 现 在 让 我 们 开始 动手 架设 目 己 的 持 
续集 成 环境 吧 | 


11.2 Hudson 简介 


优秀 的 持续 集成 工具 有 很 多 ， 如 老牌 的 开源 工具 CruiseControl、 商 
业 的 Bamboo 和 TeamCity 等 。 本 书 只 介绍 Hudson， 因 为 它 是 目前 最 流行 
的 开源 持续 集成 工具 。 该 项 目 过 去 一 直 托 管 在 java.net 社 区 ， 不 过 现在 
已 经 迁移 到 http://hudson-ci.org/。Hudson 主 要 是 由 Kohsuke Kawaguchi 开 
发 和 维护 的 ，Kohsuke Kawaguchi 自 2001 年 就 已 经 加 入 Sun 公 司 (4 
然 ， 现 在 已 经 是 Oracle 了 ) ， 不 过 当 笔 者 写 下 这 些 文字 的 时 候 ， 他 刚 宣 
布 离开 Sun/Oracle 并 开始 基于 Hudson 目 行 创业 。 


Hudson 以 其 强大 的 功能 和 易 用 的 界面 征服 了 大 量 的 用 户 ， 它 与 主 
流 的 构建 工具 、 版 本 控制 系统 以 及 自动 化 测试 框架 都 能 进行 很 好 的 集 
成 。 因 此 ， 很 多 组 织 和 公司 选择 它 作 为 自己 的 持续 集成 工具 ， 如 JBoss 
的 http://hudson.jboss.org/hudson/ 和 Sonatype 的 


https://grid.sonatype.org/ci/ ° 


Hudson 还 有 一 个 优秀 之 处 就 是 它 提 供 了 灵活 的 插件 扩展 框架 ， 大 
量 开 发 者 基于 这 种 机 制 对 Hudson 进 行 了 扩展 。 图 11-2 展 示 了 2006~2009 
年 Hudson 插 件数 量 的 增长 情况 ， 其 中 黑 柱 表示 当月 新 发 布 Hudson 插 
件 ， 白 柱 表示 当月 Hudson 插 件 的 总 数量 。 该 图 十 分 显著 地 展现 了 
Hudson 插 件 生 态 系统 的 健康 状况 。 
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图 11-2 Hudson 插件 数量 的 增长 情况 


11.3 ”安装 Hudson 


安装 Hudson 是 十 分 简便 的 。 需 要 注意 的 是 ，Hudson 必 须 运行 在 
JRE 1.5 或 更 高 的 版 本 上 。 可 以 从 http://hudson-ci.org/ 下 载 最 新 版 本 的 安 
装 包 ， 如 图 11-3 所 示 。 下 载 完 成 之 后 承 能 获得 一 个 hudson.war 文 件 。 


@ Hudson ct - Mozilla Firefox <i 


Mailing Lists | Bugs | Blog | Wiki | Chat | Twitter | Source Code 


Download hudson.war 
e Latest and —= Hudson 


e Older Cider TET EKETE supported 1.312 
changelog | past releases 


Extensible continuous integration server 


Blog roll 
Aaa 7 oo 


Releases 


Or native package 
ke Ubuntu/Debian 
a RedHat/Fedora/CentOS 
| (@ opensuse 
pes OpenSolaris/Nevada 


I FreeBSD 


Meet Hudson 
Find out what Hudson is and get 
started. 


Use Hudson 
See how to get more out of your 
Hudson. 


Extend Hudson 


Learn how to bulld Hudson or extend 
: Hudson by writing plugins 
{ J Support 
Need professional 
support? a 


图 11-3 ”下 载 Hudson 安 装 包 


最 简单 的 启动 Hudson 的 方式 是 在 命令 行 直接 运行 hudson.war: 


$ java -jar hudson. war 


Hudson 的 局 动 日 志 会 直接 输出 到 命令 行 ， 待 启动 完成 之 后 ， 用 户 
就 可 以 打开 浏览 器 输入 地 址 http://localhost: 8080/ 访 问 Hudson 的 界面 
了 ， 如 图 11-4 所 示 。 


要 停止 Hudson， 可 以 在 命令 行 按 下 Ctrl+C 键 。 


默认 情况 下 Hudson 会 在 端口 8080 下 运行 ， 这 可 能 会 与 用 户 已 有 的 
Web 应 用 相 神 突 。 这 时 ， 用 户 可 以 使 用 --httpPort 选 项 指定 Hudson 的 运行 


$ java-jar hudson.war - -httpPort =8082 


既然 安装 包 是 一 个 war 文 件 ，Hudson 上 自然 也 就 可 以 被 部 署 到 各 种 
Web 容 器 中 ， 如 Tomcat、Glassfish、Jetty 及 JBoss 等 。 


这 里 以 Tomcat 6 为 例 ， 假 设 Tomcat 的 安装 目录 为 D: \bin\apache- 
tomcat-6.0.20\， 那 么 只 需要 复制 hudson.war 至 Tomcat 的 部 署 目 了 永 D: 
\bin\apache-tomcat-6.0.20\Wwebapps， 然 后 转 到 D: \bin\apache-tomcat- 
6.0.20\bin\ 目 录 ， 运 行 startup.bat。 这 时 可 以 从 Tomcat 的 console 输 出 中 看 


到 它 部 署 hudson.war。 


@ Dashboard [Hudson] - Mozilla Firefox 


| order 


) irae Serv ARIS) SEQ LAT Shit) 


| kp” c X 4 | 页 http:z/localhost:8080/ 国安 ~ 
| À Dashboard [Hudson] | 


Welcome to Hudson! Please create new jobs to get started. 


和 于 二 或 了 于; 2010-4-5 16:17:51 Hudson ver. 1.353 


raise 


| 正在 从 hudson-ci.org (FEE... 


图 11-4 ” ”Hudson 的 初始 启动 界面 


待 Tomcat 启 动 完成 之 后 ， 打 开 浏 览 器 访问 http:/localhost: 
8080mhudson 就 能 看 到 Hudson 的 界面 了 。 用 户 可 以 将 Tomcat 作 为 一 个 系 
统 服 务 运行 ， 这 样 Hudson 束 能 自动 随 操 作 系 统一 起 启动 了 。 


11.4 准备 Subversion 仓 库 


在 正式 创建 Hudson 持 续集 成 任务 之 前 ， 需 要 准备 好 版 本 控制 系 
Zo Fe GLAS HANH i] L.A CVS ` Subversion ` Git » Mercurial® ° HF 
Subversion 可 能 是 当前 使 用 范围 最 广 的 版 本 控制 工具 ， 因 此 本 书 以 它 为 


例 进 行 介绍 。 


首先 需要 安装 Subversion 服 务 器 软件 (本 书 仅 讨论 svnserve) ° Xf 
于 大 多 数 Linux 发 行 版 和 Mac OS X 来 说 ， 该 工具 应 该 已 经 被 预先 安装 
了 。 可 以 运行 如 下 的 命令 查看 ， 见 代码 清单 11-1。 


代码 清单 11-1 ”在 Linux/Mac OS 久 中 检查 svnserve 安 装 


$ svnserve — -version 
svnserve, version 1.5.5 (r34862) 


compiled Dec 23 2008, 16:20:31 
Copyright (C) 2000-2008 CollabNet. 
Subversion is open source software, see http://subversion.tigris.org/ 
This product includes software developed by CollabNet (http://www. Collab.Net/). 


The following repository back-end (FS) modules are available: 


* fs_base : Module for working with a Berkeley DB repository. 
Seas 


* fs fs : Module for working with a plain file (FSFS) repository. 


Cyrus SASL authentication is available. 


对 于 Windows 用 户 来 说 ， 可 以 安装 Slik Subversion 


(http://www.sliksvn.com/en/download) 。 需 要 注意 的 是 ， 在 选择 安装 


类 型 的 时 候 ， 需 要 选择 complete 安 装 ， 否 则 默认 的 安装 方式 将 不 会 安装 
svnserve， 如 图 11-5 所 示 。 


J Slik Subversion 1.6.9 (x86) Setup 


Choose Setup Type 
Choose the setup type that best suits your needs 


Installs the most common program features. Recommended for most users. 


[custom | 


Allows users to choose am features will be installed and where 
they will be installed. ended for advanced users. 


All program features will be installed. Requires the most disk space. 


图 11-5 “完整 安装 Slik Subversion 


安装 完成 之 后 ， 可 以 运行 如 下 命令 进行 验证 ， 见 代码 清单 11-2。 


代码 清单 11-2 ”在 Windows 中 检查 svnserve 安 装 


D:\>svnserve — -version 
svnserve JRA 1.6.2 (SlikSvn:tagA.6.2@ 37679) WIN32 
编译 于 May 11 2009,14:06:15 
版 权 所 有 (C) 2000-2009 CollabNet. 
Subversion 是 开放 源 代 码 软 件 , 请 参阅 http://subversion.tigris.org/ 站 点 ， 
此 产品 包含 由 CollabNet (http: //www.Collab.Net/) FARE. 
FFA EG 3m (FS) 神 块 可 用 : 


+ fs_base : 模块 只 能 操作 BDB RAE. 
* fs_fs : 模块 与 文本 文件 (FSFS) 版 本 库 一 起 工作 . 


Cyrus SASL 认证 可 用 . 


接着 需要 创建 一 个 Subversion 人 仓库。 运行 命令 如 下 : 


D:\>mkdir svn-repos 


D:\>svnadmin create svn-repos \account 


svnadmin 是 用 来 创建 、 维 护 、 监 测 Subversion 仓 库 的 工具 ， 在 主流 
Linux 和 Mac OS X 上 一 般 都 是 预 装 的 。 在 Windows 上 ， 它 也 被 包含 在 
Slik Subversion 中 。 这 里 首先 创建 一 个 名 为 svn-repos 的 目录 ， 然 后 在 这 
个 目录 中 创建 一 个 Subversion 仓 库 。 


下 一 步 古 将 本 书 至 景 案例 现 有 的 代码 导入 到 这 个 Subversion 仓 库 
中 。 由 于 笔者 的 代码 和 Subversion 仓 库 在 一 台 机 絮 上 ， 因 此 直接 使 用 file 
协议 导入 (导入 之 前 应 先 使 用 mvn clean 命 令 清 除 项 目 输 出 文件 ， 这 些 
文件 是 可 以 自动 生成 的 ， 不 该 放 入 源码 库 中 ) ， 见 代码 清单 11-3。 


代码 清单 11-3 ”导入 源码 至 Subversion 仓 库 


$ svn import -m "initial import". file: ///D: /svn-repos /account /trunk 


增加 account-emai 

增加 

增加 re\test 

增加 u ¿src \test 

增加 account-email \sre\test \j \com 

增加 account-email\sre\test ava \com\juvenxu 

增加 account-email \sre \test ava \ com \juvenxu \mvnbook 

增加 account-email \sre \test \ va \com\juvenxu \mvnbook \account 

增加 account—email \sre \test \java \com\juvenxu \mvnbook \account \email 
增加 account-captcha \pom. xm] 


提交 后 的 版 本 为 工 . 


上 述 命 令 将 当前 目录 的 全 部 内 容 提 交 到 Subversion 仓 库 


的 /accounttrunk 路 径 下 ，-m 选 项 表示 提交 的 注释 。 


仓库 建立 并 初始 化 完毕 ， 束 可 以 启动 svnserve 服 务 了 : 


$ svnserve -d -r svn-repos - -listen -host 0.0.0.0 


选项 -d 表 示 将 svnserve 服 务 作 为 守护 进程 运行 ，-r 表 示 Subversion 仓 
库 的 位 置 ， 而 参数 --listen-host 是 为 了 强制 将 svnserve 绑 定 到 IP v4 地 址 
(在 有 些 系统 上 ，svnserve 会 默认 绑 定 IP v6 地 址 ， 当 Hudson 使 用 IP v4 
地 址 访问 Subversion 仓 库 的 时 候 就 会 失败 ) 。 


最 后 ， 可 以 用 简单 的 svn 命 令 检 查 插 件 svnserve 服 务 是 否 可 用 ， 见 
代码 清单 11-4。 


代码 清单 11-4 检查 Subversion 仓 库 内 容 


$ svn list svn: //192.168.1.101 /account /trunk 
. Classpath 


. project 
.settings/ 
account-captcha/ 
account-email/ 
account-parent / 
account-persist / 
pom. xm] 


至 此 ，Subversion 仓 库 就 建立 完成 了 ， 之 后 Hudson 就 可 以 基于 这 个 


仓库 运行 集成 任务 。 


11.5 Hudson 的 基本 系统 设置 


在 创建 Hudson 持 续集 成 任务 之 前 ， 用 户 需要 对 Hudson 系 统 做 一 些 
基本 的 配置 ， 包 括 JDK 安 装 位 置 和 Maven 安 装 等 在 内 的 重要 信息 都 必须 
首 移 配置 正确 。Hudson 会 使 用 这 些 配 置 好 的 JDK 及 Maven 进 行 持续 集成 
任务 。 如 果 要 使 用 Ant 或 者 Shell 来 持续 集成 项 目 ，Ant 或 Shell 的 安装 位 
置 也 应 该 预先 设置 正确 。 


用 户 应 该 单 击 Hudson 登 录 页 面 左边 的 “系统 管理 ”"”， 然 后 单 击 页 面 
右 侧 的 “系统 设置 ?以 进入 系统 设置 页 面 ， 如 图 11-6 所 示 。 


图 11-6 ”进入 系统 设置 页 面 


在 系统 设置 页 面 ， 首 和 完 要 配置 的 钙 Hudson 将 使 用 的 JDK。 在 页 面 
中 找到 对 应 的 部 分 ， 然 后 单 击 Add JDK 按 钮 ，Hudson 就 会 提示 用 户 进 
行 安 疾 。Hudson 默 认 会 提示 目 动 安装 JDK， 用 户 可 以 看 到 一 个 Install 
automatically 的 复 选 框 是 被 选 上 的 ， 当 单 击 “ 同 意 JDK 许 可 证 协议 ”并 选 
择 一 个 JDK 版 本 后 ，Hudson 束 会 目 动 下 载 安装 相应 版 本 的 JDK 。 


虽然 这 种 方式 非常 简单 ， 但 往往 用 户 在 本 机 已 经 有 可 用 的 JDK， 而 
且 不 想 花 时 间 等 竺 Hudson 去 再 次 下 载 JDK。 这 时 用 户 束 可 以 取消 选中 
Install automatically 复 选 框 ， 然 后 手动 输入 本 机 JDK 的 位 置 《往往 就 是 
JAVA_HOME 环 境 变量 的 值 ) 。 


可 以 配置 多 个 JDK， 当 你 的 项 目 需要 确保 在 多 个 不 同 版 本 JDK 上 都 
能 正确 集成 的 时 候 ， 这 一 特性 尤为 有 用 。 


JDK 的 目 动 及 手动 配置 方式 如 图 11-7 所 示 。 


与 JDK 配 置 类 似 ， 用 户 也 可 以 选择 手动 或 者 自动 安装 Maven 供 
Hudson 使 用 ， 还 可 以 安装 多 个 版 本 的 Maven 供 Hudson 集 成 任务 使 用 。 
图 11-8 显 示 了 手动 方式 指定 maven-3.0-beta-2 的 安装 位 置 。 


JDK 
JDK installations JDK 
Name jdk-1.6 


JAVA_HOME p:\java\jdk1.6.0_07 


E] install automatically ®© 


Delete JIK | 


JOK 
Name 


[V] Install automatically 


Install from java.sun.com 
Version 6 Update 19 ~ 


mı agree to the Java SE Development Kit License Agreement 
© You must agree to the license to download the JDK, 


| Delete laxtsiler | 
| Ade Installer Y | 
| Delete JDK 
| Add JDE | 


List of JDK installations on this system 


图 11-7 为 Hudson 配 置 JDK 


Maven 
Maven installations Maven 
Name maven-3.0-beta-2 


MAVEN_HOME D:\bin\apache-maven-3.0-beta-2 


_ Install automatically ® 
Delete Maven 
| Add Maven 


List of Maven installations on this system 


图 11-8 ”为 Hudson 配 置 Maven 


还 可 以 在 该 页 面 配置 MAVEN_OPTS 环 境 变 量 ， 如 图 11-9 所 示 。 关 


于 MAVEN_OPTS 环 境 变量 的 具体 解释 可 参看 2.7.1 节 。 


Maven Project Configuration 


Global MAVEN_OPTS -Xmsi28m -Xmx512m 


图 11-9 ”为 Hudson 配 置 MAVEN_OPTS 环 境 变 量 


最 后 ， 别 起 了 单 击 页 面 下 方 的 Save 按 钮 体 存 系统 设置 。 


11.6 ”创建 Hudson 任 务 


要 创建 一 个 Hudson 任 务 来 持续 集成 Maven 项 目 ， 首 先 单 击 页 面 左 
边 的 新 建 任 务 ， 然 后 就 需要 在 页 面 右边 选择 任务 的 名 称 及 类 型 。 对 于 
一 般 的 Maven 项 目 来 说 ， 可 选择 的 类 型 有 Build a free-style software 
project 和 Build a maven2 project。 前 者 不 仅 支 持 Maven 项 目 ， 还 支持 其 
他 类 型 的 构建 工具 ， 如 Ant、Shell。 对 于 Maven 用 户 来 说 ， 两 者 最 大 的 
不 同 在 于 前 者 需要 用 户 进行 多 一 点 的 配置 ， 而 后 者 会 使 用 Hudson 自 带 
的 Maven， 且 从 项 目的 POM 中 获取 足够 的 信息 以 免 去 一 些 配 置 。 除 非 
你 已 经 十 分 熟悉 Hudson， 笔 者 推荐 选择 free-style 类 型 ( 见 图 11-10) ° 
因为 这 种 方式 更 可 控制 ， 当 任务 出 现 问 题 的 时 候 也 更 容易 检查 


Hudson * All 
2 account 
Build multi-configuration project (alpha) 


Suitable for projects that need a large number of different configurations, such as testing on 
multiple environments, platform-specific builds, etc. 


© Build a free-style software project 
This is the central feature of Hudson. Hudson will build your project, combining any SCM with 
any build system, and this can be even used for something other than software build. 


Monitor an external job 
This type of job allows you to record the execution of a process run outside Hudson, even on a 
remote machine. This is designed so that you can use Hudson as a dashboard of your existing 
automation system. See the documentation for more details. 


Build a maven? project 
Build a maven2 project. Hudson takes advantage of your POM files and drastically reduces the 
configuration. 


图 11-10 ”选择 free-style 类 型 的 Hudson 任 务 


如 网 11-10 所 示 ， 输 入 任务 名 称 ， 并 选择 free-style 类 型 后 ， 单 击 OK 
按钮 即 可 进入 详细 的 任务 配置 页 面 。 


11.6.1 _ Hudson 任务 的 基本 配置 


下 面 依次 介绍 free-style 任 务 的 各 种 配置 。 首 先生 项 目的 名 称 和 搞 
述 。 当 Hudson 任 务 比较 多 的 时 候 ， 简 洁 且 有 意义 的 名 称 及 描述 惑 十 分 
重要 。 


接着 是 一 个 重要 的 选项 Discard Old Builds。 该 选项 配置 如 何 抛弃 旧 
的 构建 。Hudson 每 执行 一 次 构建 任务 ， 就 可 以 保存 相应 的 源 代码 、 构 
建 输出 、 构 建 报告 等 文件 。 很 显然 ， 如 果 每 次 构建 相关 的 文件 都 保存 
下 来 ， 将 会 渐渐 消耗 光 磁 副 空 间 。 为 此 ，Hudson 提 供 两 种 方式 让 用 户 
选择 保留 哪些 构建 任务 的 相关 文件 ， 它 们 分 别 为 : 


‘Days to keep builds: 如 有 果 其 值 为 非 空 的 N， 束 仅 保 留 N 天 之 内 的 构 
ENCE e 


‘Max#of builds to keep: 如 果 # 非 空 ， 就 仅 保留 最 多 # 个 最 近 构 建 的 
相关 文件 。 


图 11-11 所 示 的 配置 表示 最 多 保留 10 个 最 近 的 构建 。 


Project name account 


Description (Maven=@) HERRANN. —SHEFPEHRS 


IV] Discard Old Builds 


Days to keep builds 


if not empty, build records are only kept up to this number of days 


Max # of builds to keep 10 


if not empty, only up to this number of build records are kept 


| Advanced. - - | 


E] This build is parameterized 


F| Disable Build (No new builds will be executed until the project is re-enabled.) 


E] Execute concurrent builds if necessary (beta) 
JDK jdk-1.6 


JDK to be used for this project 


图 11-11 Hudson 任务 的 基本 配置 


图 11-11 中 还 有 项 目 使 用 的 JDK 配 置 ， 这 里 可 供 选 择 的 JDK 就 是 用 
户 在 系统 设置 中 预先 定义 好 的 JDK。 


11.6.2 Hudson 任务 的 源码 仓库 配置 


接着 需要 配置 项 目的 源码 控制 系统 。 在 项 目 配置 页 面 的 Source 
Code Management 部 分 ， 选 择 Subversion 单 选 按钮 ， 然 后 在 Repository 
URL 文 本 框 中 输入 项 目的 Subversion 仓 库 地 址 。 一 般 来 说 ， 该 部 分 的 其 
他 选项 保留 默认 值 即 可 ， 如 图 11-12 所 示 。 


source Code Management 


None 
cvs 
© Subversion 
Modules Repository URL svn://192.168.1.101/account/trunk 


Local module directory (optional) 


| 
| Add more locations... | 


Use update J 


If checked, Hudson will use 'svn update’ whenever possible, making the build faster, But this 
causes the artifacts from the previous build to remain when a new build starts. 


一 
If checked, Hudson will do ‘svn revert’ before doing 'svn update’, This slows it down, but will 
prevent files being modified from build to build. 

Repository browser (Auto) 


| Advanced . 


图 11-12 ”Hudson 任 务 的 源 代 码 管 理 配 置 


需要 注意 的 是 ， 如 果 访 问 Subversion 仓 库 需 要 认证 ，Hudson 会 自动 
探测 并 提示 用 户 输入 认证 信息 ， 如 图 11-13 所 示 。 


® Subversion 


Modules Repository URL 


svn://192.168.1.101/account/trunk ® 


Unable to access svn:/ /192.168.1.101/account/trunk : 


© svn: No access allowed to this repository (show details) 
(Maybe you need to enter credential?) 


图 11-13 Hudson 提示 用 户 输入 源码 仓库 的 认证 信息 


单 击 enter credential 后 ，Hudson 会 弹出 一 个 页 面 让 用 户 选 择 认证 方 
式 并 输入 认证 信息 。 输 入 正确 信息 之 后 ，Hudson 就 能 读 取 仓库 源 代码 
了 。 图 11-14 采 用 了 用 户 名 和 密码 的 方式 进行 认证 。 


e Subversion Authentication 


Repository URL syn://192.168.1.101/account/trunk 


© Username/password authentication 


User name juven 


Password eeccecee 


SSH public key authentication (svn+ssh) 


HTTPS client certificate 


图 11-14 ”为 Subversion 仓 库 添 加 认证 信息 


11.6.3 “Hudson 任务 的 构建 触发 配置 


再 往 下 的 Build Triggers 部 分 配置 的 是 触发 构建 的 方式 。 可 选 的 三 种 
方式 分 别 为 : 


-Build after other projects are built: 在 其 他 项 目 构建 完成 之 后 构建 本 
项 目 。 


.Build periodically: 周期 性 地 构建 本 项 目 。 


‘Poll SCM: 周期 性 地 轮 询 源码 仓库 ， 发 现 有 更 新 的 时 候 构建 本 项 


如 无 特殊 高 级 的 需要 ， 一 般 不 会 选择 第 一 种 方式 ， 而 第 二 种 方式 
显然 会 造成 一 些 无 谓 的 构建 ， 如 采 几 次 构建 所 基于 的 源 代码 没有 任何 
区 别 ， 构 建 的 输出 往往 也 束 不 会 有 变化 ; 第 三 种 方式 就 没有 这 个 问 
题 ， 它 能 避免 无 请 的 构建 ， 克 省 持续 集成 服务 器 的 资源 。 这 种 周期 轮 
询 源 代 码 仓库 的 方式 实际 上 也 是 最 常用 的 构建 触发 方式 。 


既然 是 轮 询 ， 就 需要 配置 轮 询 的 频率 ，Hudson 使 用 了 著名 的 UNIX 
任务 调度 工具 Cron (http://en.wikipedia.org/wiki/Cron) 所 使 用 的 配置 方 
式 。 这 种 配置 方式 使 用 5 个 字段 表示 不 同 的 时 间 单 位 (字段 之 间 用 空格 
或 制 表 符 分 隔 ) : 


每 个 字段 表示 的 意义 及 值 范围 分 别 为 : 

分 : 一 小 时 中 的 分 钟 (0~59) 。 

时: 一 天 中 的 小 时 (0~23) ° 

日 : 一 月 中 的 日 期 (1~31) ° 

JH: 月 份 (1~12) 。 

.星期 几 : 一 周 中 的 星期 几 (0~7，0 和 7 都 表示 星期 天 ) 。 


其 中 每 个 字段 除了 可 以 使 用 其 范围 内 的 值 以 外 ， 还 能 使 用 一 些 特 


.#: 星 号 表示 匹配 范围 内 所 有 值 。 
M-N: 连 字 符 表示 匹配 M~N 范 围 内 的 所 有 值 ， 如 “1-5”。 
:A，B，...，Z: 逗号 表示 匹配 多 个 值 ， 如 “0，15，0”。 


*/X 或 M-N/X: 范围 加 上 和 斜 杠 表示 匹配 范围 内 能 被 X 整 除 的 值 ， 
如 “1-10/3” 就 等 同 于 “3， 6, 9” o 


下 面 一 些 例子 可 以 帮助 读者 理解 这 种 强大 的 配置 方式 : 


RK , 每 分 钟 o 


5 每 小 时 中 的 第 5 分 钟 。 


2/1 Q****. 每 隔 10 分 钟 o 


4510**1-5: 每 周一 到 周 五 的 上 午 10: 45。 


.0，30*13*5: 每 月 13 号 的 每 半 小 时 ， 或 者 每 周 五 的 每 半 小 时 。 


对 于 一 个 健康 的 项 目 来 说 ， 篆 见 的 做 法 是 : 每 隔 10 分 钟 轮 询 代 码 
仓库 ， 如 图 11-15 所 示 。 


Build Triggers 


T] Build after other projects are built 


Build periodically 


J| Poll SCM 


Schedule */19 **** 


图 11-15 ”Hudson 任务 的 代码 仓库 轮 询 配置 
在 配置 轮 询 的 时 候 ， 还 可 以 使 用 人 #* 添 加 注释 ， 此 外 空 日 的 行 会 被 
忽略 。 例 如 : 


# check if there is any subversion update every 15 minutes 


WL、 Ke HE 


11.6.4 Hudson 任务 的 构建 配置 
接 下 来 要 告诉 Hudson 使 用 运行 Maven 命 令 构 建 项 目 。 单 击 Build 部 


分 中 的 Add build step 下 三 角 按 钮 ， 然 后 选择 Invoke top-level Maven 
targets， 如 图 11-16 所 示 。 


Add build step Y 


f 
| Execute shell 
Invoke Ant 


Invoke top-level Maven targets 


Execute Windows batch command 


a T 


Isage 


图 11-16 ”选择 Maven 作 为 Hudson 任 务 的 构建 工具 


再 选择 一 个 安装 好 的 Maven 版 本 ， 输 入 Maven 命 令 如 clean deploy 
可 以 了 ， 如 图 11-17 所 示 。 需 要 注意 的 是 ， 日 常 持续 集成 任务 如 有 果 成 功 
的 话 ， 都 会 生成 快照 版 的 项 目 构 件 。 如 果 维 护 了 一 个 Maven 私 服 ， 那 么 
持续 集成 任务 束 应 当 目 动 将 构件 部 署 到 私服 中 ， 供 其 他 项 目 使 用 。 这 
也 就 是 这 里 的 Maven 命 令 应 当 为 clean deploy 的 原因 。 


至 此 ， 一 个 Hudson 任 务 基 本 配置 完成 ， 单 击 Save 按 钮 保存 后 就 能 
看 到 图 11-18 所 示 的 页 面 。 这 时 ， 可 以 单 击 页 面 左边 的 “立即 生成 ”来 手 
动 触发 第 一 次 集成 。 


Build 
Invoke top-level Maven targets 


Maven Version | maven-3.0-beta-2 


Goals ‘clean deploy 


[e] 
E2 


| Advanced... 
Delete 


Add build step ~ | 
图 11-17 Hudson 任务 的 Maven 构 建 命令 配置 


Hudson » account 


Project account 


(Maven=&@) FPRSARE. 一 个 蝶 产 注册 舌 务 


[J Subversion Polling Lo 


永久 连接 
© Last build(#1),3.1 sec# 


Build History (#3) 

© #1 2010-4-11 16:51:04 
i A ae a 
DEANE 


图 11-18 配置 完成 的 Hudson 任 务 


(2) 


11.7 ”监视 Hudson 任 务 状态 


Hudson 提 供 了 丰富 友好 的 图 形 化 界面 ， 让 用 户 从 各 方面 了 解 各 个 
任务 的 当前 及 历史 状态 ， 这 包括 整体 的 列表 显示 、 目 定义 视图 、 单 个 
任务 的 具体 信息 ， 如 构建 日 志和 测报 报告 等 。 用 户 应 该 基于 Hudson 提 
供 的 信息 尽 可 能 地 将 持续 集成 任务 稳定 在 健康 的 状态 。 


11.7.1 全 局 任务 状态 

Hudson 的 默认 主页 面 显示 了 当前 服务 器 上 所 有 集成 任务 的 状态 ， 
如 图 11-19 所 示 ° 

这 个 页 面 主 要 由 四 个 部 分 组 成 : 


SUH: 位 于 页 面 左 上 方 ， 方 便 用 户 执行 各 类 Hudson 操 作 ， 如 
新 建 任务 、 系 统管 理 等 。 


-生成 队列 : 页 面 左边 中 间 的 部 分 ， 表 示 等 竺 执行 构建 的 任务 ， 如 
图 11-19 中 有 一 个 maven3 的 构建 任务 在 等 待 生成 队列 中 。 


.生成 状态 : 页 面 左 边 下 面 的 部 分 ， 表 示 正 在 执行 构建 的 任务 ， 如 
图 11-19 中 有 一 个 account 的 构建 任务 正在 执行 。 


-任务 状态 : 页 面 右边 的 部 分 ， 显 示 了 所 有 任务 的 状态 。 


AKEHE 


11 sec 


5 min 19 sec 


图 11-19 Hudson 的 全 局 任务 状态 


下 面 重 点 介绍 任务 状态 。 在 上 默认 情况 下 ， 这 里 列 出 了 Hudson 中 所 
有 任务 的 状态 ， 其 中 的 每 一 列 从 左 到 右 分 别 表示 任务 当前 状态 、 天 
气 ， 名 称 、 上 次 成 功 的 时 间 、 上 次 失败 的 时 间 、 上 次 持续 的 时 间 以 及 
左右 一 个 立即 执行 的 按钮 (方便 用 户 手动 触发 执行 任务 ) 。 


其 中 需要 解释 的 是 当前 状态 及 图 中 第 一 列 (S) 下 的 球形 图 标 。 
Hudson 使 用 各 种 颜色 表示 任务 当前 的 状态 : 


Ext 
[Et 


: 任务 最 近 一 次 的 构建 是 成 功 的 。 
红色: 任务 最 近 一 次 的 构建 是 失败 的 。 


黄色: 任务 最 近 一 次 的 构建 表 成 功 了 ， 但 不 稳定 (主要 是 因为 有 
失败 的 测试 ) 。 


ARE: 任务 从 未 被 执行 过 或 者 被 花 用 了 。 
如 有 果 图 标 在 闪烁， 表示 任务 正在 执行 一 次 构建 。 


图 中 的 第 二 列 天 气 (W) 也 需要 稍 作 解释 。Hudson 使 用 一 组 天 气 
的 图 标 表示 任务 长 期 的 一 个 状态 ， 它 们 分 别 为 : 


万 里 上 晴空， 任务 80% 以 上 的 集成 都 是 成 功 的 。 


稍 有 乌云 ， 任 务 有 60%~80% 的 集成 是 成 功 的 。 
乌云 密布 ， 任 务 只 有 40%~60% 的 集成 是 成 功 的 。 
先 阴 两 绵绵 ， 任 务 的 集成 成 功率 只 有 2096-409%6 。 


售 所 风雷 呜 ， 任 务 的 集成 成 功率 不 到 20% 。 


关于 全 局 状态 需要 再 次 强调 的 是 ， 当 团队 看 到 任务 的 集成 状态 不 
够 健康 有 时， 应 该 尽快 采取 措施 修复 问题 。 


11.7.2” 目 定义 任务 视图 


在 一 个 稍 有 规模 的 公司 或 者 组 织 下 ， 持 续集 成 服务 左上 往往 会 有 
很 多 的 任务 ，Hudson 上 默认 的 视图 会 列 出 所 有 服务 右上 的 任务 ， 太 多 的 
任务 就 会 造成 寻找 的 不 便 。 为 此 Hudson 能 让 用 户 自 定义 视图 ， 选 择 只 
列 出 感 兴趣 的 任务 ， 甚 至 还 能 目 定 义 视图 中 显示 的 列 。 


用 户 可 以 单 击 默认 视图 Al 和 劳 边 的 加 号 (+) 以 添加 一 个 自 定 义 视 
图 ， 如 图 11-20 所 示 。 


Name mvn-book 


Description 5 (Mavenz#) #%ome 


Filter build queue 
Filter build executors F 


Jobs 


| account 


C| maven3 
Use a regular expression to include jobs into the view 
Columns 


Status 


Weather 


图 11-20 ”添加 目 定 义 Hudson 任 务 视 图 


图 11-20 添 加 了 一 个 名 为 mvn-book 的 任务 视图 ， 该 视图 仅 包含 
account 一 个 任务 ， 并 且 只 显示 状态 、 天 人气、 任务 名 三 列 。 用 户 可 以 根 
据 目 己 的 需要 ， 选 择 要 包含 的 任务 和 要 显示 的 列 ， 甚 至 还 能 使 用 正则 
表达 式 来 匹配 要 显示 的 任务 名 。 上 述 配 置 保存 后 的 效果 如 图 11-21 所 


= (Maven=[{) 福 关 的 项 吉 


All mvn-book + 


Ss 


二 


图 11-21 自 定 义 Hudson 任 务 视 图 效果 


11.7.3 ”单个 任务 状态 


在 任务 视图 中 ， 单 击 某 个 任务 名 称 就 能 进一步 查看 该 任务 的 状 
态 。 图 11-22 显 示 了 account 项 目 任务 的 一 个 整体 状态 。 


Project account 
(Mavenz@) HHRRARS. —tE HESS 


Test Result Trend 


AE 
Ni 


A $ 
a 
tow 
© 
© 
2 
E 


加 
io 
A 
z 
5 


u ion iry 
Latest Test S 
Build History (29) Resuit(no failures) 


@ #5 2010-4-12 9:59:23 
永久 连接 


@ #4 2010-4-12.9:20:51 
@ #3 2010-4-12 9:10:51 ® Last build(=5),1 da 

. ast stable build(=5 aoe y Sher 
@ #2 2010-4-11 17:01:54) . successful build(=5),1 day 5 hr#t 
@ #1 2010-4-11 16:51:04 


DD 


Oo a NOU nm9N DO 


#2 


图 11-22 ”单个 Hudson 任 务 的 状态 


图 11-22 包 含 了 丰富 的 信息 。 左 下 角 是 构建 历史 (Build History) ， 
该 例 中 显示 了 最 近 5 次 全 部 成 功 的 构建 ， 包 括 每 次 构建 的 时 间 。 图 11-22 
下 方 还 有 3 个 永久 连接 ， 分 别 指向 了 最 近 一 次 构建 、 最 近 一 次 失败 的 构 
建 以 及 最 近 一 次 成 功 的 构建 。 无 论 构 建 历史 还 是 永久 连接 ， 我 们 都 能 
单 击 某 一 个 构建 以 了 解 更 具体 的 信息 。 例 如 ， 单 击 图 11-22 构 建 历史 中 
的 #4 构建 ， 就 可 以 看 到 图 11-23 所 示 的 内 容 。 


Hudson » account » #4 


(Ð 生成 #4 (2010-4-12 9:20:51) sense 


开始 于 1 day 6 hrs 
Het 11 sec 


y poke As] 
ERES: 4 
Changes 
1. add developers config for jason (detail) 


Started by an SCM change 


B Test Result(no failures) 


图 11-23 Hudson 任务 的 单 次 构建 信息 


请 注意 图 11-23 左 上 和 角 的 导航 信息 ，Hudson>account>#4 表 示 当 前 的 
位 置 是 Hudson 服 务 器 下 account 任 务 的 第 4 次 构建 。 从 图 11-23 中 可 以 了 
解 到 这 次 构建 所 发 生 的 时 间 、 相 关 的 代码 变更 等 信息 。 


需要 指出 的 是 ， 在 图 11-23 中 左边 的 命令 行 输出 链接 。 当 构建 失败 
的 时 候 ， 了 解 这 次 构建 的 命令 行 输入 至 关 重 要 。 单 击 该 链接 后 可 以 看 
到 图 11-24 所 示 的 页 面 。 


O 命令 行 输出 


Started br an SCM change 

Updating svn://192. 168. 1. 101/account/ trunk 

U account~parent pos xml 

At revision 4 

[trunk] $ D:\bin\apache-maven-3. O-alpha-6\bin\mvn. bat clean install 
[INFO] Scanning for projects... 


] Reactor Build Order: 


Account Aggregator 
Account Parent 

] Account Email 
Account Persist 

O] Account Captcha 


] Building Account Aggregator 1. 0. O-SNAPSHOT 


-~ 一 maven-clean-plugin:2.3:clean (default-clean) © account-aggregator 一 一 


] -一 maven-install-plugin:2 3:install (default-install) @ account-aggregator 一 一 
Installing D:\hudson-work\ jobs\account \workspace\trunk\pom xml to D:\java\repositorr 


图 11-24 Hudson 执行 构建 的 命令 行 输出 
在 图 11-22 中 还 有 一 些 链接 包含 了 丰富 的 信息 ， 例 如 最 近 变 更 集 。 


单 击 该 链接 束 能 看 到 项 目 最 近 的 代码 变更 ， 如 图 11-25 所 示 。 


变更 集 
#4 (2010-4-12 9:20:51) 


4. add developers config for jason — jason / detail 


#3 (2010-4-12 9:10:51) 


3. add developers config for admin — admin / detail 
2. add developers config 一 Juven Xu / detail 


11-25 “Hudson 任务 的 变更 集 


除了 变更 集 ， 还 可 以 单 击 工作 区 ， 以 图 形 化 的 方式 查看 该 Hudson 
从 源码 库 取得 的 源码 文件 及 构建 输入 文件 ， 如 图 11-26 所 示 。 


= trunk / account-captcha / src / main / 


svn 


java/com/juvenxu/mvnbook/account/captcha 
fi resources 


图 11-26 Hudson 任务 的 工作 区 


11.7.4 Maven 项 目测 试 报告 


图 11-22 还 显示 了 项 目的 测试 结果 信息 ， 为 了 获得 这 样 的 信息 需要 
做 一 些 额 外 的 配置 。 在 11.6.1 节 中 ，maven-surefire-plugin 会 在 项 目的 
target/surefire-reports 目 孙 下 生成 与 JUnit 兼 容 的 XML 格式 测试 报告 ， 
Hudson 能 够 基于 这 种 格式 的 文件 生成 图 形 化 的 测试 报告 。 


用 户 可 以 配置 一 个 Hudson 任 务 ， 在 配置 页 面 的 Post-build Actions 部 
选择 Publish JUnit test result report 先 项 ， 并 且 将 Test report XMLs 赋 值 


为 **/target/surefire-reports/TEST-*.xml ° 


该 表达 式 表 示 匹 配 任意 目录 下 target/surefire-reports/ 子 目录 中 以 
TEST- 开 头 的 XML 文 件 ， 这 也 就 是 匹配 所 有 maven-surefire-plugin 生 成 的 
XML 格 式 报 告 文件 。 配 置 如 图 11-27 所 示 。 


¥) Publish JUnit test result report 


Test report XMLs **/target/surefire-reports/TEST-*.xm| 


Fileset ‘includes’ setting that specifies the generated raw XML report files, such as 
'myproject/target/test-reports/*.«ml', Basedir of the fileset is the workspace root 


图 11-27 ”配置 Hudson 任 务 发 布 测试 报告 


有 了 上 述 配 置 之 后 ， 就 能 在 任务 状态 页 面 中 看 到 最 新 的 测试 结果 
与 测试 结 末 趋势 ， 如 图 11-28 所 示 。 


Test Result Trend 


111-28 Hudson 任务 测试 的 总 体 状 态 


单 击 Latest Test Result 吕 能 看 到 最 近 一 次 构建 的 测试 报告 。 在 测试 
结果 趋势 图 中 ， 用 户 也 可 以 单 击 各 个 位 置 得 到 对 应 构建 的 测试 报告 ， 
如 图 11-29 所 示 。 


用 户 还 可 以 单 击 图 中 的 链接 得 到 更 具体 的 测试 输出 ， 以 方便 定位 


并 修复 问题 。 


如 采用 户 为 一 个 Hudson 任 务 配置 了 测 弃 报 告 ， 束 可 以 同时 配置 构 
建 命令 忽略 测试 。 例 如 ， 图 11-17 中 的 Maven 构 建 命令 可 以 更 改 为 clean 
deploy-Dmaven.test.failure.ignore， 这 样 失 败 的 测试 就 不 会 导致 构建 失 
败 。 也 就 是 说 ， 构 建 的 状态 不 会 是 红色 ， 同 时 ， 由 于 Hudson 能 够 解析 
测试 报告 并 发 现 失败 的 测试 ， 构 建 的 状态 也 不 会 是 健康 的 蓝 色 。 用 户 
最 终 会 看 到 黄色 的 任务 状态 ， 表 示 构 建 不 稳定 。 这 种 配置 方式 能 够 帮 
助 用 户 区 分 失败 的 构建 与 不 稳定 的 构建 。 


Test Result 


1 failures (+1) 
9 tests (+0) 
Took 3.6 sec. 


Snes 


All Failed Tests 


Test Name Duration Age 


>>> com.juvenxu.mvnbook.account.captcha.AccountCaptchaServiceTest.testValidateCaptchaCorrect 0.047 


All Tests 


Package Duration Fail (diff) Skip (diff) Total (diff) 
com.juvenxu.mvynbook.account.captcha 2.7 sec | +1 


com.juvenxu.mvnbook.account.email 0.47 sec 
com .juvenxu.mvnbook.account.persist 0.48 sec 


图 11-29 一 次 构建 的 测试 报告 


11.8 Hudson 用 户 管理 


与 一 般 软 件 的 用 户 管理 方式 不 同 的 是 ， 使 用 Hudson 时 ， 不 需要 主 
动 创建 用 户 ，Hudson 能 够 在 访问 源码 仓库 的 时 候 上 自动 获取 相关 用 户 信 
轧 并 存储 起 来 。 这 大 大 人 商 化 了 用 户 管理 的 步 又 。 


以 11.4 节 建立 的 Subversion 仓 库 为 例 ， 默 认 该 仓库 是 匿名 可 读 的 ， 
认证 用 户 可 写 ， 不 过 我 们 并 没有 配置 任何 用 户 。 现 在 要 关闭 匿名 可 读 
权限 ， 同 时 添加 一 些 用 户 。 本 书 不 涉及 过 多 的 配置 细 廊 ， 可 以 参考 

《Subversion 与 版 本 控制 》 (http://svnbook.red-bean.com/) 一 书 。 


首先 ， 编 辑 Subversion 仓 库 下 conf/svnserve.conf 文 件 中 的 
[general] 小 节 如 下 : 


[general] 
anon-access =none 
auth-access =write 


passwora-aDp = passw d 


这 里 的 anon-access=none 表 示 匿 名 用 户 没有 任何 权限 ，auth- 
access=write 表 示 经 认证 用 户 拥有 读 写 权限 ， 而 password-db=passwd 表 示 
存储 用 户 信息 的 数据 位 于 同 级 目 孙 下 的 passwd 文 件 中 。 再 编辑 
conf/passwd 文 件 如 下 : 


[users] 
admin =admini23 
juven = juven123 


jason =jasoni23 


这 里 为 仓库 配置 了 三 个 用 户 ， 等 号 左边 是 用 户 名 ， 右 边 则 是 密 
码 。 


至 此 ， 就 完成 了 一 个 简单 的 Subversion 仓 库 用 户 权 限 配置 。 像 日 常 
开发 一 样 ， 接 下 来 在 Subversion 客 户 端 分 别 使 用 这 几 个 用 户 名 对 代码 进 
行 更 改 后 提交 至 Subversion 仓 库 。 例 如 ， 对 account-parent 模 块 的 
pom.xml 加 入 developers 配 置 后 ， 再 使 用 如 下 svn 命 令 提 区 更 改 ; 


D: \svn \account > svn commit-m "add developers config" - -username juven — —pass- 
word juvenl123 

正在 发 谈 account-parent \pom. xml 

传输 文件 数据 . 


提交 后 的 版 本 为 2 . 


然后 使 用 另外 两 个 用 户 admin 与 jason 分 别 对 代码 进行 更 改 并 提交 ， 
Hudson 会 很 快 轮 询 到 Subversion 仓 库 内 的 更 改 ， 然 后 取得 更 改 的 代码 信 
息 ， 并 了 解 到 这 些 更 改 是 由 谁 提交 的 。 


等 Hudson 得 到 这 些 更 改 并 触发 集成 任务 之 后 ， 相 关 的 Subversion 用 
户 信 息 束 已 经 被 Hudson 存 储 起 来 了 。 单 击 Hudson 页 面 左边 的 用 户 ， 然 
后 束 能 在 页 面 右边 看 到 相关 的 用 户 信 息 ， 包 括 用 户 名 、 最 近 活 动 时 间 
及 相关 的 Hudson 任 务 ， 如 图 11-30 所 示 。 


Last Active t 


4 min 33 sec 


14 min 


14 min 


图 11-30 ”Hudson 目 动 获 得 的 用 户 信息 


当然 ， 仅 仅 知道 用 户 名 是 不 够 的 ， 还 需要 为 用 户 添 加 详细 信息 ， 
其 中 最 重要 的 就 是 E-mail 地 址 ， 因 为 它 将 被 用 来 发 送 邮 件 反 馈 ( 详 见 
11.97) 。 单 击 某 个 用 户 的 名 称 (如 juven) ， 然 后 再 单 击 页 面 左 边 的 
设置 ， 在 右边 的 用 户 设置 页 面 中 ， 可 以 配置 用 户 的 名 称 (不 同 于 
Subversion ID ， 该 名 称 应 该 更 容易 识别 人 ) 、 简 要 描述 、 个 性 化 视图 以 
及 最 重要 的 E-mail 地 址 ， 如 图 11-31 所 示 。 


Hudson » juven 
Your name Juven Xu 


Description Maven 实 战 》 的 作者 


My Views 
Default View All 
The view selected by default when navigating to the users private views 


E-mail 


E-mail address juvenshun@gmail.com 


Your e-mail address, like j 


图 11-31 配置 Hudson 用 户 的 详细 信息 


单 击 Save 按 钮 后 ， 一 个 Hudson 用 户 的 信息 惑 完 整 了 。 


11.9 ”邮件 反馈 


持续 集成 中 非常 重要 的 一 个 步骤 就 是 反馈 。 集 成 的 状态 信息 (万 
其 是 不 健康 的 状态 信息 ) 必须 及 时 地 通知 给 相关 团队 成 员 ， 而 最 常见 
的 反 弓 方式 殉 是 使 用 电子 邮件 。 本 小 节 介 绍 如 何 配置 Hudson 来 及 时 地 
KIER BU TREBLE ° 


首先 需要 做 的 是 为 Hudson 配 置 邮件 服务 器 信息 。 进 入 11.5 节 提 到 的 
系统 设置 页 面 ， 找 到 E-mail Notification 部 分 ， 然 后 输入 以 下 信息 : 


-SMTP server: SMTP 邮 件 服务 器 地 址 。 


‘Default user e-mail suffix: 默认 用 户 邮 件 后 缀 。 当 用 户 没 有 配置 邮 
件 地 址 的 时 候 ，Hudson 会 目 动 为 其 加 上 该 邮件 后 级 。 当 用 户 数量 很 
多 ， 并 旦 邮件 地 址 都 是 一 个 域名 的 时 候 ， 该 功能 就 显得 尤其 重要 ， 例 
如 配置 后 缀 为 @foo.com， 且 用 户 mike 没 有 配置 邮件 地 址 ， 那 么 当 
Hudson 需 要 发 邮件 给 mike 的 时 候 就 会 发 送 到 mike@foo.com ° 


.System Admin E-mail Address: 系统 管理 员 邮 件 地 址 ， 即 Hudson 邮 
件 提示 所 使 用 的 发 送 地 址 。 


-Hudson URL: Hudson 服务器 的 地 址 。 该 地 址 往往 被 包含 在 电子 邮 
件 中 以 方便 用 户 访问 Hudson 取 得 进一步 的 信息 ， 因 此 要 确保 该 地 址 在 


用 户 机 器 上 是 可 访问 的 。 


:SMTP Authentication: SMTP 相 关 的 认证 配置 。 


完整 的 邮件 服务 器 配置 如 图 11-32 所 示 。 


E-mail Notification 


SMTP server smtp.gmail.com v 


Default user e-mail suffix @juvenxu.com 

System Admin E-mail Address hudson@juvenxu.com 
Hudson URL http://192.168.1.101:8080/ 
7| Use SMTP Authentication 

User Name hudson 


Password eeeeeeecoces 


Use SSL 


SMTP Port 


图 11-32 Hudson 邮件 服务 配置 


配置 完成 后 ， 可 以 单 击 图 11-32 右 下 角 的 测试 按钮 ， 让 Hudson 发 一 
封 邮 件 至 系统 管理 员 邮 件 地 址 以 确认 配置 成 功 。 


接 下 来 要 做 的 是 配置 Hudson 任 务 使 用 邮件 反馈 。 进 入 任务 的 配置 
页 面 ， 然 后 找到 最 后 Post-build Actions 小 节 中 的 E-mail Notification 复 选 
框 ， 将 其 选 上 。 现 在 要 关心 的 是 两 个 问题 ， 什 么 样 的 构建 会 触发 邮件 
反馈 ? 邮件 会 发 送 给 谁 ? 


REBT Ala, BRIA: 


:失败 的 构建 会 触发 邮件 反馈 。 


成 功 构 建 后 的 一 次 不 稳定 构建 会 触发 邮件 反馈 。 不 稳定 往往 是 由 
失败 的 测试 引起 的 ， 因 此 成 功 后 的 一 次 不 稳定 往往 表示 有 回归 性 测试 
FM ° 


:失败 或 不 稳定 构建 后 的 一 次 成 功 构建 会 触发 邮件 反馈 ， 以 通知 用 
户 集成 恢复 到 了 健康 状态 。 


用 户 可 以 配置 是 否 每 次 不 稳定 构建 都 触发 邮件 反馈 。 


关于 第 二 个 问题 ， 首 先 可 以 在 Recipients 中 配置 一 个 邮件 列表 (用 
空格 分 离 ) ， 列 表 中 的 用 户 会 收 到 所 有 邮件 反馈 。 一 般 来 说 ， 项 目 负 
责 人 应 该 在 这 个 列表 中 。 


其 次 ，Hudson 还 提供 一 个 选项 : Send separate e-mails to individuals 
who broke the build。 当 用 户 选 择 该 选项 后 ， 邮 件 会 发 送 给 所 有 与 这 次 
构建 相关 的 成 员 ， 即 那些 提交 了 本 地 构建 代码 更 新 的 成 员 。Hudson 无 
法 精确 地 知道 到 底 是 谁 的 代码 提交 导致 了 构建 失败 ， 因 此 只 能 通知 所 
有 与 代码 更 新 相关 的 成 员 。 


典型 的 邮件 反馈 配置 如 图 11-33 所 示 。 


v| E-mail Notification 
Recipients admin@juvenxu.com 
Whitespace-separated list of recipient addresses. E-mail will be sent when a build fails. 


7| Send e-mail for every unstable build 


V| Send separate e-mails to individuals who broke the build 


411-33 ”为 Hudson 任 务 配置 邮件 反馈 


最 后 需要 解释 的 是 ， 图 11-33 中 的 Send e-mail for every unstable build 
选项 表示 是 否 为 所 有 的 不 稳定 构建 触发 邮件 反馈 ， 如 果 不 将 其 选中 ， 
只 有 成 功 构建 后 的 第 一 次 不 稳定 构建 才 会 触发 邮件 反馈 。 推 荐 的 做 法 
是 将 其 选 上 。 敏 捷 高 效 的 团队 不 应 该 忽略 持续 集成 中 的 任何 不 健康 因 
素 o 


、 
人 


X 


11.10 Hudson 工作 目录 


到 目前 为 止 ， 本草 都 古 从 用 户 界 面 的 角度 介绍 Hudson 的 各 种 功 
能 。 用 心 的 读者 可 以 想象 到 ，Hudson 的 各 种 配置 、 任 务 、 报 告 肯定 是 
以 文件 的 形式 存储 在 位 副 中 的 。 这 束 是 Hudson 的 工作 目 隶 ， 了 解 该 目 
孙 不 仅 能 帮助 读者 理解 Hudson 用 户 界 面 中 的 各 种 特性 ， 更 重要 的 是 ， 
读者 需要 明白 怎样 为 Hudson 分 配合 理 的 磁盘 空间 ， 长 期 运行 的 持续 集 
成 服务 往往 会 消耗 大 量 的 磁盘 空间 ， 理 解 哪些 任务 对 应 的 哪些 文件 消 
耗 了 多 少 磁 盘 空间 ， 对 持续 集成 服务 的 维护 来 说 至 关 重 要 。 


默认 情况 下 ，Hudson 使 用 用 户 目 录 下 的 .hudson/ 目 录 作 为 其 工作 目 
录 。 例 如 ， 在 笔者 的 Vista 系 统 上 ， 该 目录 为 C: \Users\juven\.hudson\, 
而 在 Linux 系 统 上 ， 该 目录 为 home/juven/.hudson/。 由 于 该 目录 会 渐渐 
消耗 大 量 的 磁盘 空间 ， 因 此 用 户 往往 会 希望 自 定义 该 工作 目录 的 位 
置 ， 这 时 用 户 可 以 设置 环境 变量 HUDSON_HOME， 例 如 将 其 设置 为 


D: \hudson-work。 关 于 如 何 设 置 环境 变量 ， 请 参考 2.1.3 有 和 2.2.1T。 
一 个 典型 的 Hudson 工 作 目 录 包 含 的 内 容 如 图 11-34 所 示 。 
对 这 些 文 件 、 日 录 的 解释 如 下 : 


xml: 这 些 XML 文 件 是 Hudson 核 心 及 相关 插件 的 配置 ， 如 
config.xml 配 置 了 全 局 的 JDK、 任 务 视图 等 信息 ， 


hudson.tasks.Maven.xml 配 置 了 Maven 安 装 信息 ， 


hudson.tasks.Mailerxml 配 置 了 邮件 服务 器 信息 ， 等 等 。 


Name 
E3 jobs 
ip) Plugins 
je Updates 
E userContent 


ipa users 


config xml 


O hudson.maven.MavenModuleSet.xml 


j| hudson.model.UpdateCenter.xml 
hudson.scm,CVSSCM xml 
hudson.scm.SubversionSCM.xml 

| hudson.tasks.Ant.xml 
hudson.tasks.Mailer.xml 

| hudson.tasks Maven.xml 
hudson.tasks.Shell.xml 
hudson.triggers. SCMTrigger.xml 


nodeMonitors.xml 


| secret.key 


11-34 Hudson LVER RANA 


: 如 果 用 户 独 立 运 行 hudson.war， 那 么 其 内 容 会 
孙 中 后 再 局 动 。 


被 释放 到 该 目 


‘users: Hudson 所 存储 的 用 户 信 息 。 


-userContent: 用 户 可 以 将 任意 内 容 放 到 该 目 永 下 后 通过 Hudson 服 
务 页 面 的 子路 径 访问 ， 如 http://192.168.1.101: 8080/userContent/ ° 


‘updates: 这 里 存储 了 各 类 可 更 新 的 插件 信息 。 


‘plugins: 所 有 Hudson 插 件 都 被 安装 在 该 目录 而 不 会 影响 到 Hudson 
的 核心 。 


jobs: 该 目录 包含 了 所 有 Hudson 任 务 的 配置 、 存 储 的 构建 、 归 档 
的 构建 输出 等 内 容 。 本 市 称 后 会 详细 解释 该 目 邓 。 


上 述 目 录 中 最 重要 的 可 能 就 是 jobs 子 目录 了 ， 这 里 包含 了 所 有 
Hudson 的 任务 配置 、 每 个 任务 的 工作 区 、 构 建 历史 等 信息 ， 具 体内 容 
如 图 11-35 所 示 。 


图 11-35 中 的 jobs 目 录 下 有 两 个 子 目 录 account 科 maven3， 它 们 分 别 
对 应 了 两 个 Hudson 任 务 。 每 个 任务 都 会 包含 如 config.xml ` 
nextBuildNumber、scm-polling.log 等 文件 ， 其 中 的 config.xml 包 含 了 该 
任务 的 所 有 配置 ， 如 SCM 地 址 、 轮 询 频 率 等 。 


每 个 任务 目录 下 会 包含 一 个 workspace 子 目录， 这 就 是 该 任务 的 工 
作 区 。 这 里 有 最 近 一 次 构建 所 包含 的 源 代码 及 相关 输出 。 


任务 目录 下 还 有 一 个 builds 子 目 孙 ， 该 目录 包含 了 所 有 Hudson 记 
录 的 历史 构建 ， 每 个 构建 对 应 了 一 个 目录 ， 这 些 目 录 都 是 以 构建 所 发 
生 的 时 间 命 名 的 ， 如 2010-04-15_14-56-08， 每 个 构建 目录 包含 了 一 些 
文件 记录 其 成 功 失败 信息 、 构 建 日 志 、 测 试 报告 、 变 更 记录 等 。 如 果 
用 户 为 该 任务 配置 了 文件 归档 ， 那 么 每 次 构建 归档 的 内 容 都 会 存储 在 
archive 子 目录 下 。 


7 Ba jobs 
v g account 
v E builds 
b [E 2010-04-12_09-20-51 
b je 2010-04-13_15-50-57 
b E 2010-04-14 13-56-16 
b BD 2010-04-15 14-49-53 
v E 2010-04-15_14-56-08 
> iE archive 
人 S| build.xml 


g| changelog.xml 


© junitResult xm! 
| log 


三 | revision .txt 
~ g workspace 
b aa trunk 
@| config.xml 
“| nextBuildNumber 


_ | scm-polling.log 


svnexternals.txt 


> E maven3 


11-35 ”Hudson 工作 目录 的 jobs 子 目录 内 容 


可 以 想象 ， 如 果 用 户 没 有 如 11.6.1 节 中 介绍 的 那样 抛弃 旧 的 构建 ， 
那么 每 次 构建 的 记录 都 会 保存 在 任务 目录 的 builds 子 目 隶 下。 随 着 时 间 
的 推移 ， 这 些 记 录 会 消耗 大 量 的 磁盘 空间 ， 因 此 用 户 在 使 用 Hudson 的 


By) AR DM AF BSE a eg OU ENAERE, TS SF A 
的 构建 记录 。 


11.11 “)25 


本 章 关 注 的 是 持续 集成 。 首 先 介绍 了 持续 集成 相关 的 概念 ， 在 此 
基础 上 ， 再 引入 最 流行 的 持续 集成 服务 软件 
易于 安装 ， 它 与 主流 的 版 本 控制 工具 都 集成 得 很 好 ， 为 了 真实 地 体现 
寺 续 集成 场景 ， 本 章 人 简略 介绍 了 如 何 染 设 位 单 的 Subversion 仓 库 。 使 用 
Hudson 创 建 持 续集 成 任务 会 涉及 很 多 配置 ， 如 JDK 安 装 、Maven 安 
淡 、 源 码 库 、 构 建 触 发 方式 、 构 建 命令 等 ， 本 草 配 以 大 量 的 图 片 以 帮 
助 读 者 使 用 和 理解 这 些 配置 。 任 务 创建 完成 后 ， 还 能 从 各 方面 了 解 任 
务 的 状态 ， 包 括 成 功 与 否 、 测 试 报告 、 源 码 变 更 记录 等 。Hudson 还 能 
够 智能 地 收集 用 户 信 息 ， 读 者 可 以 配置 Hudson 为 用 户 提 供 邮 件 反 馈 。 
本 章 的 最 后 介绍 了 Hudson 的 工作 目 隶 ， 以 帮助 读者 更 好 地 维护 持续 集 
成 服务 。 


Hudson。Hudson 非 常 


第 12 章 ”使 用 Maven 构 建 Web 应 用 


"Web 项 目的 目录 结构 

-account-service 

‘account-web 

.使 用 jetty-maven-plugin 进 行 测试 

.使 用 Cargo 实 现 自 动 化 部 署 

:小结 

到 目前 为 止 ， 本 书 讨论 的 只 有 打包 类 型 为 JAR 或 者 POM 的 Maven 
项 目 。 但 在 现今 的 互联 网 时 代 ， 我 们 创建 的 大 部 分 应 用 程序 都 是 Web 
应 用 ， 在 Java 的 世界 中 ，Web 项 目的 标准 打包 方式 是 WAR。 因 此 本 章 
介绍 一 个 WAR 模 块 account-web， 它 也 来 目 于 本 书 的 账户 注册 服务 
背景 案例 。 在 介绍 该 模块 之 前 ， 本 章 还 会 先 实现 account-service。 此 


外 ， 还 介绍 如 何 借助 jetty-maven-plugin 来 快速 开发 和 测 斌 Web 模块， 以 
及 使 用 Cargo 实 现 Web 项 目的 目 动 化 部 署 。 


12.1 


Web 项 目的 目 永 结构 


我 们 都 知道 ， 基 于 Java 的 Web 应 用 ， 其 标准 的 打包 方式 是 WAR 。 
WAR 与 JAR 类 似 ， 只 不 过 它 可 以 包含 更 多 的 内 容 ， 如 JSP 文 件 、 
Servlet、Java 类 、web.xml 配 置 文件 、 依 赖 JAR 包 、 静 态 web 资 源 (如 
HTML、CSS、JavaScript 文 件 ) 等 。 一 个 典型 的 WAR 文 件 会 有 如 下 目 


KEM: 


-war / 


i 


+ sample, jsp 


META-INF / 
WEB-INF / 

+ classes/ 

| + ServletA. class 


+ config. properties 
t 


| 

| 

| 

t 

| + 

| + mail-1.4,.1.jar 
| + 

| 

+ 


index. html 


—TSWAR FB eT A Se: META-INF 和 WEB-INF。 前 
者 包含 了 一 些 打 包 元 数据 信息 ， 我 们 一 般 不 去 关心 ;后 者 是 WAR 包 的 
核心 ，WEB-INF 下 必须 包含 一 个 web 资 源 表述 文件 web.xml， 它 的 子 目 
录 classes 包 含 所 有 该 Web 项 目的 类 ， 而 男 一 个 子 目录 lib 则 包含 所 有 该 
Web 项 目的 依赖 JAR 包 ，classes 和 1lib 目 录 都 会 在 运行 的 时 候 被 加 入 到 
Classpath 中 。 除 了 META-INF 和 WEB-INF 外 ， 一 般 的 WAR 包 都 会 包含 
很 多 Web 资 源 ， 例 如 你 往往 可 以 在 WAR 包 的 根 目 录 下 看 到 很 多 html 或 者 
jsp 文 件 。 此 外 ， 还 能 看 到 一 些 文件 夹 如 img、css 和 js， 它 们 会 包含 对 应 
的 文件 供 页 面 使 用 。 


同 任 何其 他 Maven 项 目 一 样 ，Maven 对 Web 项 目的 布局 结构 也 有 一 
个 通用 的 约定 。 不 过 首先 要 记 住 的 是 ， 用 户 必 须 为 Web 项 目 显 式 指定 打 
包 方式 为 war， 如 代码 清单 12-1 所 示 。 


代码 清单 12-1 显 式 指定 Web 项 目的 打包 方式 为 war 


如 果 不 显 式 地 指定 packaging，Maven 会 使 用 默认 的 jar 打 包 方 式 ， 
从 而 导致 无 法 正确 打包 Web 项 目 。 


Web 项 目的 类 及 资源 文件 同一 般 JAR 项 目 一 样 ， 默 认 位 置 都 是 
src/main/java/ 和 src/main/resources， 测 试 类 及 测试 资源 文件 的 默认 位 置 
是 src/test/java/ 和 src/test/resources/。Web 项 目 比 较 特殊 的 地 方 在 于 : E 
还 有 一 个 Web 资 源 日 隶 ， 其 默认 位 置 是 src/main/webapp/。 一 个 典型 的 
Web 项 目的 Maven 目 录 结 构 如 下 : 


+ project 


+ pom. xml 


t 


src/ 

+ main/ 

| Java/ 

| | + ServletA. java 
| Re Ses 

| | 

| + resources / 

| | + config. properties 
|| 4 

| | 

| + webapp 

| + WEB-INF / 
| | + web. xml 
| | 

| + img / 

| | 

| t CSS 

| | 

| + js 

| + 

| + index. htr 
| + Sample. j 
| 

+ 


在 src/main/webapp/ 目 录 下 ， 必 须 包 含 一 个 子 目录 WEB-INF， 该 子 
目录 还 必须 要 包含 web.xml 文 件 。src/main/webapp 目 录 下 的 其 他 文件 和 
目录 包括 html、jsp、css、JavaScript 等 ， 它 们 与 WAR 包 中 的 Web 资 源 完 
全 一 致 。 


在 使 用 Maven 创 建 Web 项 目 之 前 ， 必 须 首先 理解 这 种 Maven 项 目 结 
构 和 WAR 包 结构 的 对 应 关系 。 有 一 点 需要 注意 的 是 ，WAR 包 中 有 一 个 
lib 目 录 包 含 所 有 依赖 JAR 包 ， 但 Maven 项 目 结构 中 没有 这 样 一 个 目录 ， 
这 是 因为 依赖 都 配置 在 POM 中 ，Maven 在 用 WAR 方 式 打 包 的 时 候 会 根 
据 POM 的 配置 从 本 地 仓库 复制 相应 的 JAR 文 件 。 


12.2 account-service 


本 章 将 完成 背景 案例 项 目 ， 读 者 可 以 回顾 第 4 章 ， 除 了 之 前 实现 的 
account-email 、account-persist 和 account-captcha 之 外 ， 该 项 目 还 包括 
account-service 和 account-web 两 个 模块 。 其 中 ，account-service 用 来 封 
装 底 层 三 个 模块 的 细 下 ， 并 对 外 提供 简单 的 接口 ， 而 account-web 仅 包 
台 一 些 涉及 Web 的 相关 内 容 ， 如 Servlet 和 JSP 等 。 


12.2.1 account-serviceHJPOM 


account-service 用 来 封装 account-email ` account-persist#llaccount- 
captcha 三 个 模块 的 细节 ， 因 此 它 肯 定 需 要 依赖 这 三 个 模块 。account- 
service 的 POM 内 容 如 代码 清单 12-2 所 示 。 


代码 清单 12-2 ”account-service 的 POM 


<project xmlns = "http://maven.apache.org/POM/4.0.0" 

xmlns:xsi = "http://Wwww.w3.o0rg/2001 /XMLSchema-instance" 

xsi:schemaLocation = "http://maven. apache. org/POM/4.0.0 

http: //maven. 

apache. org /maven-v4_0_0.xsd" > 

<modelVersion >4.0.0 < /modelVersion > 

<parent > 
< groupId > Com. juvenxu.mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId> 
<version >1.0.0-SNAPSHOT < /version > 

</parent > 


<artifactiId > account-service < /artifactId > 
<name >Account Service < /name > 


<properties > 


<greenmail. version >1.3,.1b< /greenmail. version > 
< /properties > 


< dependencies > 
< dependency > 
<grouplid > $ {project. groupid} < /groupid > 
<artifactId >account-email < /artifactId> 
<version> $ {project. version} < /version > 
< /dependency > 


< dependency > 
<groupid> $ {project. groupiId} < /groupid > 
<artifactId >account-persist < /artifactId> 
<version> $ {project. version} < /version > 
< /dependency > 
< dependency > 
<groupid > $ {project. groupId} < /groupId > 
<artifactId >account-captcha < /artifactId > 
<version> $ {project. version} < /version > 
< /dependency > 
< dependency > 
<groupid >junit < /groupid > 
<artifactid >junit < /artifactId > 
< /dependency > 
< dependency > 
<groupid > Com. icegreen < /groupIid > 
<artifactId >greenmail < /artifactId> 
<version> $ {greenmail. version} < /version > 
< scope >test < /scope > 
< /dependency > 
< /dependencies > 
<build> 
<testResources > 
<testResource > 
<directory >src/test /resources < /directory > 
<filtering >true</filtering > 
< /testResource > 
< /testResources > 
< /build> 
< /project > 


与 其 他 模块 一 样 ，accountrservice 继 承 自 account-parent， 它 依赖 于 
account-email 、account-persist 和 account-captcha 三 个 模块 。 由 于 是 同一 
项 目 中 的 其 他 模块 ，groupId 和 version 都 完全 一 致 ， 因 此 可 以 使 用 
Maven 属 性 $ {project.groupId} 和 $ {project.version} 进 行 替 换 ， 这 样 可 以 
在 升级 项 目 版 本 的 时 候 减 少 更 改 的 数量 。 项 目的 其 他 配置 如 junit 和 
greenmail 依 赖 ， 以 及 测试 资源 目录 过 滤 配 置 ， 都 是 为 了 单元 测试 。 前 


面 的 章节 已 经 介绍 过 ， 这 里 不 再 著述 。 


12.2.2 account-serviceH = (tS 


account-service 的 目的 是 封 狠 下 层 细 方 ， 对 外 又 露 尽 可 能 简单 的 接 
口 。 先 看 一 下 这 个 接口 是 怎样 的 ， 见 代码 清单 12-3。 


代码 清单 12-3 AccountService.java 


package com. juvenxu.mvnbook. account. service; 
public interface AccountService 


String generateCaptchakKey () 
throws AccountServiceException; 


byte[] generateCaptchalImage({ String captchakey ) 
throws AccountServiceException; 


void signUp ( \UpRequest signUpRequest ) 
throws AccountServiceException; 


void activate ( String activationNumber ) 
throws AccountServiceException; 


void login( String id, String password ) 
throws AccountServiceException; 


正如 4.3.1 广 介绍 的 那样 ， 该 接口 提供 5 个 方法 。generateCaptchaKey 
O 用 来 生成 一 个 验证 码 的 唯一 标识 符 。generateCaptchaImage () 根 
据 这 个 标识 符 生 成 验证 码 图 片 ， 图 片 以 字 节 流 的 方式 返回 。 用 户 需 
使 用 signUp () 方法 进行 注册 ， 注 册 信 息 使 用 SignUpRequest 进 行 封 
JE 


R, X SignUpRequest R E — Tin RAPOJO, EAA SF EMTID ` 
email ` HP% ` BAS > WUEBERNR ` WEE Se o TEM RZ 


后 ， 用 户 会 得 到 一 个 激活 链接 ， 该 链接 包含 了 一 个 激活 码 ， 这 个 时 候 
用 户 需要 使 用 activate () 方法 并 传 入 激活 码 以 激活 账户 。 最 后 ，login 
() 方法 用 来 登录 。 


下 面 来 看 一 下 该 接口 的 实现 类 AccountServiceImpl.java。 首 先 它 需 
要 使 用 3 个 底层 模块 的 服务 ， 如 代码 清单 12-4 所 示 。 


代码 清单 12-4 ”AccountServiceImpl.java 第 1 部 分 


public class Account riceImpl 
ingie ments Account zice 


private AccountPersistService accountPersistService; 


private AccountEmailService accountEmailService; 


private AccountCaptchaService accountCaptchaService; 
ublic AccountPersistService getAccountPersistService () 
g 


return accountPersistService; 
public void setAccountPersistService( AccountPersistService accountPe 


this. account PersistService =accountPersistService; 


三 个 私有 变量 来 自 account-persist、account-email 和 account-captcha 


模块 ， 它 们 都 有 各 自 的 get () 和 set () 方法 ， 并 且 通 过 Spring 注入 。 


AccountServiceImpl.java 借 助 accountCaptchaService 实 现 验证 码 的 标 
识 和 从 生成 及 验证 码 图 片 生成 ， 如 代码 清单 12-5 所 示 。 


rsist- 


代码 清单 12-5 AccountServiceImpl.java 第 2 部 分 


public byte[] generatecaptchaImage( String captchaKey ) 
throws AccountServiceException 


{ 
try 
{ 
return accountCaptchaService.generateCaptchaImage ( captchaKey ); 
} 
catch ( AccountCaptchaException e ) 
{ 
throw new AccountServiceException ("Unable to generate Captcha Image.", e ); 
} 
} 


public String generateCaptchakey () 
throws AccountServiceException 
{ 
try 
{ 
return accountCaptchaService. generateCaptchaKey (); 
} 
catch ( AccountCaptchaExceptione ) 
{ 
throw new Account ServiceException( "Unable to generate Captcha key.", e); 


~ 


稍微 复杂 一 点 的 是 signUp () 方法 的 实现 ， 见 代码 清单 12-6 © 
代码 清单 12-6 AccountServiceImpl.java 第 3 部 分 


private Map <String, String> activationMap =new HashMap <String, String> (); 


public void signUp( SignUpRequest signUpRequest 
throws AccountServiceException 


try 
{ 


t 


if (!signUpRequest . get Password (). equals (signUpRequest . getConfirmPassword {))) 
{ 


throw new AccountServiceException( "2 passwords do not match." ); 


, 


} 


if (!accountCaptchaService 
. validateCaptcha (signUpRequest. getCaptchakey (),signUpRequest. 
getCaptchaValue())) 


{ 


throw new AccountServiceException( "Incorrect Captcha." ); 


} 


Account account =new Account (); 

account. setId( signUpRequest.getId() ); 

account. setEmail ( sigqnUpRequest.getEmail () ); 
account. setName ( signUpRequest. getName () }; 

account. setPassword( signUpRequest.get Password () ); 
account. setActivated( false ); 


accountPersistService. createAccount ( account ); 
String activationId =RandomGenerator. getRandomString (); 
activationMap. put ( activationld, account.getId() ); 


String link =signUpRequest.getActivateServiceUrl ().endsWith( "/" ) ? sign- 
UpRequest.getActivateServiceUr] () 
+ activationId : signUpRequest. getActivateServiceUrl () + "?key =" + 


activationIid; 


accountEmailService. sendMail ( account. getEmail(), "Please Activate Your 
Account", link ); 


catch ( AccountCaptchaException e ) 


throw new AccountServiceException( "Unable to validate captcha.", e ); 


catch ( AccountPersistException e ) 
throw new AccountServiceException( "Unable to create account. e); 
} 
catch ( AccountEmailException e ) 
{ 
throw new AccountServiceException( "Unable to send actiavtion mail.", e); 


} 


signUp () 方法 首先 检查 请 求 中 的 两 个 密码 是 否 一 致 ， 接 着 使 用 
accountCaptchaService 检 查验 证 码 ， 下 一 步 使 用 请 求 中 的 用 户 信息 实例 
化 一 个 Account 对 象 ， 并 使 用 accountPersistService 将 用 户 信息 保存 。 下 
一 步 是 生成 一 个 随机 的 激活 码 并 保存 在 临时 的 activateMap 中 ， 然 后 基 
于 该 激活 码 和 请 求 中 的 服务 器 URL 创 建 一 个 激活 链接 ， 并 使 用 
accountEmailService 将 该 链接 发 送 给 用 户 。 如 果 其 中 任何 一 步 发 生 异 


7, signUp () 方法 会 创建 一 个 一 致 的 AccountServiceExcpetion 对 象 
提供 并 抛 出 对 应 的 异常 提示 信息 。 


最 后 再 看 一 下 相对 简单 的 activate () 和 login () 方法 ， 见 代码 清 
单 12-7。 


代码 清单 12-7 AccountServiceImpl.java 第 4 部 分 


String accountId =activationMap. get ( activationid ); 


if ( accountId ==nulli ) 
{ 
throw new AccountServiceException( “Invalid account activation ID." ); 


try 

{ 
Account account =accountPersistService. readAccount ( accountId ); 
account. setActivated( true ); 
account PersistService. updateAccount ( account ); 

} 

catch ( AccountPersistException e ) 

{ 


throw new AccountServiceException( "Unable to activate account." ); 


public void login{ String id, String password } 
throws AccountServiceException 


try 
{ 


Account account =account PersistService. readAccount ( id ); 


if ( account ==null ) 
{ 


throw new AccountServiceException( "Account does not exist.” ); 


if ( !account.isActivated({) ) 
{ 


throw new AccountServiceException( “Account is disabled." ); 


if ( !account.getPassword(). equals ( password ) ) 
{ 
throw new AccountServiceException( "Incorrect password." ); 


catch ( AccountPersistException e } 
{ 
throw new AccountServiceException( "Unable to log in.", e); 


activate () 方法 仅仅 是 简单 根据 激活 码 从 临时 的 activationMap 中 寻 
找 对 应 的 用 户 ID， 如 果 找 到 就 更 新 账户 状态 为 激活 。login O 方法 则 


征 根据 ID 读 取 用 户 信息 ， 检 查 其 是 否 为 激活 ， 并 比 对 密码 ， 如 采 有 任 
何 错误 则 抛 出 异 间 。 


除了 上 述 代码 之 外 ，account-service 还 包括 一 些 Spring 配 置 文件 和 
单元 测试 代码 ， 这 里 天 不 再 详细 介绍 。 有 兴趣 的 读者 可 以 目 行 下 载 阅 


eet 


[1] 由 于 篇 幅 的 原因 ， 这 里 不 再 给 出 源 代 码 ， 有 兴趣 的 读 着 可 以 目 行 下 
载 并 查看 本 书 源码 。 


12.3 account-web 


account-web 是 本 书 背 景 案例 中 唯一 的 Web 模 块 ， 本 书 中 在 用 该 模 
块 来 阐述 如 何 使 用 Maven 来 构建 一 个 Maven 项 目 。 由 于 account-service 
已 经 封装 了 所 有 下 层 细节 ，account-web 只 需要 在 此 基础 上 提供 一 些 
Web 页 面 ， 并 使 用 简单 Servlet 与 后 台 实 现 交 互 控 制 。 读 者 将 会 看 到 一 


个 具体 web 项 目的 POM 是 怎样 的 ， 也 将 能 体会 到 让 Web 模 块 尽 可 能 简 


洁 市 来 的 好 处 。 


12.3.1 account-web 的 POM 


除了 使 用 打包 方式 war 之 外 ，Web 项 目的 POM 与 一 般 项 目 并 没 多 大 
的 区 别 。account-web 的 POM 代 人 码 见 代码 清单 12-8。 


代码 清单 12-8 ”account-web 的 POM 


<?xml version = "1.0"?> 
<project 
xSi:schemaLocation = "http://maven. apache. org/POM/4.0.0 
http://maven. 
apache. org/xsd/maven-4.0.0.xsd" 
xmins = "http: //maven. apache. org/POM/4.0.0" 
xmlns:xsi = “http://www. w3.org/2001 /XMLSchema-instance" > 
<modelVersion >4.0.0 < /modelVersion > 
<parent > 
<grouptId > com. juvenxu.mvnbook. account < /groupId > 
<artifactid >account-parent < /artifactid > 


< version >1.0.0-SNAPSHOT < /version > 
< /parent > 


<artifactId >account-web < /artifactId> 
< packaging >war < /packaging > 
<name >Account Web < /name > 


< dependencies > 
< dependency > 
<groupld > $ {project.groupId} < /groupid > 
<artifactId >account-service < /artifactiId> 
<version > $ (project. version} < /version > 
< /dependency > 
< dependency > 
<groupId > javax. servlet < /GroupIG > 
<artifactId >servlet-api < /artifactId> 
<version >2.4 < /version > 
< scope > provided < /scope > 
< /dependency > 
< dependency > 
<groupId > javax. servlet. jsp < /groupId> 
<artifactId >jsp-api < /artifactId> 
<version >2.0 </version> 


cope > provided < /scope > 


< /dependency > 


dependencies > 


如 上 述 代 码 所 示 ，account-web 的 packaging 元 素 值 为 war， 表 示 这 是 
一 个 web 项 目 ， 需 要 以 war 方 式 进 行 打包 。account-web 依 赖 于 servlet-api 
和 jsp-api 这 两 个 几乎 所 有 Web 项 目 都 要 依赖 的 包 ， 它 们 为 servlet 和 jsp 的 
编写 提供 文 持 。 需 要 注意 的 是 ， 这 两 个 依赖 的 范围 是 provided， 表 示 它 
们 最 终 不 会 被 打包 至 war 文 件 中 ， 这 是 因为 几乎 所 有 Web 容 句 部 会 提供 
这 两 个 类 库 ， 如 果 war 包 中 重复 出 现 ， 束 会 导致 潜在 的 依赖 冲突 问题 。 
account-web 还 依赖 于 account-service 和 和 spring-web， 其 中 前 者 为 Web 应 用 
提供 底层 支持 ， 后 者 为 Web 应 用 提供 Spring 的 集成 支持 。 


在 一 些 Web 项 目 中 ， 读 者 可 能 会 看 到 finalName 元 素 的 配置 。 该 元 
素 用 来 标识 项 目 生 成 的 主 构件 的 名 称 ， 该 元 素 的 默认 值 已 在 超级 POM 
中 设 定 ， 值 为 $ {project.artifactId}- {project.version}， 因 此 代码 清单 
12-8 对 应 的 主 构 件 名 称 为 account-web-1.0.0-SNAPSHOT.war。 不 过 ， 这 
样 的 名 称 显然 不 利于 部 署 ， 不 管 是 测试 环境 还 是 最 终 产 品 环境 ， 我 们 
都 不 想 在 访问 页 面 的 时 候 输 入 宛 长 的 地 址 ， 因 此 我 们 会 需要 名 字 更 为 
人 简洁 的 war 包 。 这 时 可 以 如 下 所 示 配 置 finalName 元 素 : 


<finalName >account < /finalName > 


经 此 配置 后 ， 项 目 生 成 的 war 包 和 名称 束 会 成 为 account.war， 更 方便 
部 署 。 


12.3.2 account-webHy = (3 


account-web 的 主 代 码 包 含 了 2 个 JSP 页 面 和 4 个 Servlet， 它 们 分 另 


i 


‘signup.jsp: 账户 注册 页 面 。 
-login.jsp: 账户 登录 页 面 。 


-CaptchalmageServlet: 用 来 生成 验证 码 图 片 的 Servlet ° 


.LoginServlet: 人 处理 账 户 注册 请 求 的 Servlet ° 
“ActivateServlet: 处 理 账 户 激活 的 Servlet ° 
.LoginServlet: 处 理 账户 登录 的 Servlet 。 


Servlet 的 配置 可 以 从 web.xml 中 获得 ， 该 文件 位 于 项 目的 
src/main/webapp/WEB-INF/ 目 隶 。 其 内 容 见 代码 清单 12-9。 


代码 清单 12-9 ”account-web 的 web.xml 


< IDOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc. //DTD Web Application 2.3//EN" 


"http://java.sun.com/dtd/web-app_2_3.dtd" > 


<web-app > 


<display—-name > Sample Maven Project: Account Service 
<listener > 

< listener-class >org. springframewor 
stener-class > 

< /listener > 


< /Gisplay 
k. web, 


“name > 
context 
< context -param > 


ontext Loader! 
< param- 


stener 
name > contextCo 
<param-value > 


igLocation < /param-name > 
asspath: /account-persist. xml 
clasepath: /account-captcha. xml 
classpath: /account-email.xml 
classpath: /account-service. xml 
< /param-value > 
< f/context-param > 
<servlet > 
servlet—name >CaptchalmageServlet < /serviet-name > 
< rvlet-class > com. juvenxu.mvynbook, account.web.CaptchaImageServlet </ serv- 
let-clag 
< /Se@r > 
<servlet > 
< sory et- servlet-nam 


x. account 


ignUpServlet < 
vlet-name > Ac 


tivateSe 
-class > com. j 


/servie 


t- 
rvlet < /serv 
uver 


ear 


vlet-name > 
axu. mynbook. account 


.web, Acti 


t-name >LoginServl 
class > 


vlet < /servlet—name > 
com. juvenxu. mynbook 

< / Ser vi et > 

<servl 


account. web. LoginServlet </ser 
et-mapping > 
cserviet-name >CaptchalmageServlet < /serv 
<url-pattern > /c 


>/¢ cha_image < 
< /servlet-—mapping > 
<servl WE > 
<servlet—name > 


t-name > 
¿ /url-pattern > 

SignUpServilet < /servlet-nam 
<url-pattern > /signup < /url—pattern> 
< /servlet-—mapping > 
<servlet-mapping > 

< servlet-name >Activat 
<url 


-pattern > /activa 


eServiet < /servlet-—name > 
e < /url-pattern > 
< /servlet-mapping > 
<servlet-—mapping > 
<servilet-name >LoginServlet < /: 
<url-pattern > /login < /ur 
< /servlet-mapping > 
/web-app > 


/servlet-name > 
pattern > 


web.xml 首 先 配 置 了 该 Web 项 目的 显示 名 称 ， 接 着 是 一 个 名 为 
ContextLoaderListener 的 ServletListener。 该 listener 来 和 目 spring-web 
人 WE yas 


E 


来 为 Web 项 目 启 动 Spring 的 IoC 容 器 ， 从 而 实现 Bean 的 注入 。 名 为 
contextConfigLocation 的 context-param 则 用 来 指定 Spring 配置 文件 的 位 


置 。 这 里 的 值 是 四 个 模块 的 Spring 配置 XML 文件 ， 例 如 

classpath: /Waccount-persist,xml 表 示 从 classpath 的 根 路 径 读 取 名 为 
account-persist.xml 的 文件 。 我 们 知道 account-persist,xml 文 件 在 account- 
persist 模 块 打 包 后 的 根 路 径 下 ， 这 一 JAR 文 件 通 过 依赖 的 方式 被 引入 到 


account-webf‘Jclasspath F ° 


web.xml 中 的 其 余部 分 是 Servlet， 包 括 各 个 Servlet 的 名 称 、 类 名 以 
及 对 应 的 URL 模 式 。 


下 面 来 看 一 个 位 于 src/main/webapp/ 目 录 的 signup.jsp 文 件 ， 该 文件 
用 来 呈现 账户 注册 页 面 。 其 内 容 如 代码 清单 12-10 所 示 。 


代码 清单 12-10 signup.jsp 


<% @ page contentType = "text /html; charset =UTF-8" language = "java" % > 
<% @ page import = "com. juvenxu.mvnbook. account.service. *, 
org. springframework. context.ApplicationContext, 
org. springframework.web. context. support.WebApplicationContextUtils"% > 
<html > 
<head > 
<style type = "text/css" > 


</style> 
< /head > 
<body > 


<$ 
ApplicationContext context = WebApplicationContextUtils.getWebApplicationContext ( 
getServletContext () ); 


AccountService accountervice = (AccountService) context.getBean ( "accountSer- 
vice" ); 

String captchakey = accountervice. generateCaptchaKkey (); 

% > 


<div class ="text-field"> 


<h2 > 注册 新 账户 < /h2 > 

< form name = "signup" action = "signup" method = "post" > 
<label >#KP ID: </label > <input type = "text" name = "id" > </input > <br/> 
<label >Email: < /label > <input type = "text" name = "email"> < /input > 


<br/> 

<label > 显示 名 称 : < /label > <input type = "text" name = "name" > < /input > 
<br/> 

<label > 密码 :< /label > <input type = "password" name = "password" > < /input > 
<br/> 


<label > 确认 密码 :< /label > <input type = "password" name = "confirm_passworda" > 
</input > <br/> 

< label > 验证 码 : < /label > <input type = "text" name = "captcha_value" > < /in- 
put > <br/> 

<input type = "hidden" name = "captcha_key" value="<% =captchaKey% >"/> 

<img src="<% =request.getContextPath()% > /captcha_image?key = <% =cap- 
tchakey% >"/> 

< /br > 


<button > 确认 并 提交 < /button > 
</form> 


</div> 


< /body > 
< /html > 


该 JSP 的 主题 是 一 个 name 为 signup 的 HTML FORM， 其 中 包含 了 
ID、Email、 名 称 、 密 码 等 字段 ， 这 与 一 般 的 HTML 内 容 并 无 差别 。 不 
同 的 地 方 在 于 ， 该 JSP 文 件 引 入 了 Spring 的 ApplicationContext 类 ， 并 且 


用 此 类 加 载 后 台 的 accountService， 然 后 使 用 accountService 先 生成 一 个 
验证 码 的 key， 再 在 FORM 中 使 用 该 key 调 用 captcha_image 对 应 的 Servlet 
生成 其 标识 的 验证 码 图 片 。 需 要 注意 的 是 ， 上 述 代 码 中 略 去 了 css 片 


段 。 
账户 注册 页 面 如 独 12-1 所 示 。 


上 壕 JSP 中 使 用 到 了 /captcha_image 这 一 资源 获取 验证 码 图 片 。 根 据 
web.xml， 我 们 知道 该 资源 对 应 了 CaptchaImageServlet。 下 面 看 一 下 它 
的 代码 ， 见 代码 清单 12-11 ° 


注册 新 账户 
账户 ID: juven 


Email: test@juvenxu. com 


显示 名 称 ， Juven Xu 
密码 : EZELI] 
RUED: eeceeee 


SUF: 6c8xT 


图 12-1 账户 注册 页 面 
代码 清单 12-11 CaptchalmageServlet.java 


package com. juvenxu. mvnbook, account. web; 


import java.io. IOException; 
import ... 


public class CaptchaImageServlet 
extends HttpServlet 
t 


private ApplicationContext context; 


private static final long serialVersionUID =5274323889605521606L; 


@ Override 
public void init () 
throws ServletException 


super. init (); 


context =WebApplicationContextUtils.get 


letContext () ) 
} 
public void doGet (HttpServletRequest request, 
throws ServletException, 
IOException 
String key =request.getParameter( "key" ); 


if (key ==null || key. length() ==0 ) 


response. sendError (400, “No Captcha Key Found" ); 


AccountService service (AccountService) context. getBea 
try 
response. setContentType{ "image/jpeg" ); 


OutputStream out = response. getOutputStream(); 
out.write( service. generateCaptchaImage( key ) ); 


out.close(); 
? 
catch ( AccountServiceException e ) 


response. sendError (404, e.getMessage() ); 


CaptchalmageServletfzinit () 方法 中 初始 化 Spring 的 


n ( 


etWebApplicationContext ( getServ- 


HttpServletResponse response) 


"account— 


ApplicationContext， 这 一 context 用 来 获取 Spring Bean 。Servlet 的 doGet 
() 方法 中 首先 检查 key 参 数 ， 如 果 为 空 ， 则 返回 HTTP 400 错 误 ， 标 识 

客户 端的 请 求 不 合法 ， 如 有 果 不 为 空 ， 则 载 入 AccountService 实 例 。 该 类 

HJgenerateCaptchalmage () 方法 能 够 产生 一 个 验证 码 图 片 的 字 节 流 ， 


我 们 将 其 设置 成 image/jpeg 格 式 ， 并 写 入 到 Servlet 相 应 的 输出 流 中 ， 


户 端 就 能 得 到 图 12-1 所 示 的 验证 码 图 片 。 


代码 清单 12-10 中 FROM 的 提交 目标 是 signup， 其 对 应 了 


SignUpServlet。 其 内 容 如 代码 清单 12-12 所 示 。 
代码 清单 12-12 SignUpServlet.java 


public class SignUpServlet 
extends HttpServlet 


TR 


private static final long serial VersionUID =4784742296013868199L; 
private ApplicationContext context; 


@ Override 
public void init () 
throws ServletException 
{ 
super.init(); 
context = WebApplicationContextUtils. getWebApplicationContext ( getServ— 
letContext() ); 
} 


@ Override 
protected void doPost ( HttpServletRequest reg, HttpServletResponse resp ) 
throws ServletException, 
IOException 


String id =req. getParameter( "id" ); 

String email =req.getParameter( "email" ); 

String name =req. getParameter ( "name" ); 

String password = rea. getParameter ( "password" ); 

String confirmPassword =req. getParameter( "confirm_password" ); 
String captchakey = req. getParameter ( "captcha_key" ); 

String captchaValue =req.getParameter( "captcha_value" }; 


if (id==null ||id.length({)==0 || email ==null || email.length() ==0 || 
name ==null 
|| mame. length() ==0 || password ==null || password. length() ==0 ||con- 
firmPassword ==null 
|| confirmPassword. length () ==0 || captchaKey ==null || captchaKey. length 
() ==0 || captchaValue ==null 
|| captchaValue. length() ==0 ) 


{ 
resp. sendError (400, "Parameter Incomplete." }); 
return; 


) 


AccountService service = (AccountService) Context ,SetBean ( “accountSer- 
vice" ); 


SignUpRequest request =new SignUpRequest {); 


request. setId( id }; 

request.setEmail ( email }; 

request. setName (name ); 

request. set Password ( password ); 

request. setConfirmPassword ( confirmPassword ); 
request. setCaptchaKey ( captchaxkey ); 

request. setCaptchaValue( captchaValue ); 


request. setActivateServiceUrl ( getServletContext (). getRealPath( “/") + 
"activate" ); 


try 


service. signUp( request ); 
resp.getWriter().print( "Account is created, please check your mail box 


for activation link." ); 
catch ( AccountServiceException e ) 


resp. sendError ( 400, e. getMessage({) ); 


return; 


SignUpServletiJdoPost () 接受 客户 端的 HITP POST 请 求 ， 首 移 它 
读 取 请 求 中 的 id、name、email 等 参数 ， 然 后 验证 这 些 参数 的 值 是 否 为 
空 ， 如 果 验 证 正确 ， 则 初始 化 一 个 SignUpRequest 实 例 ， 其 包含 了 注册 
账户 所 需要 的 各 类 数据 。 其 中 的 activateServiceUrl 表 示 服 务 应 该 基于 什 
么 地 址 发 送 账户 激活 链接 邮件 ， 这 里 的 值 是 与 signup 平 行 的 activate 地 
址 ， 这 正 是 ActivationServlet 的 地 址 。SignUpServlet 使 用 AccountService 
注册 账户 ， 所 有 的 细节 都 已 经 封装 在 AccountService 中 ， 如 果 注 册 成 


功 ， 服 务 右 打印 一 条 简单 的 提示 信息 。 


上 面 介绍 了 一 个 JSP 和 两 个 Servlet， 它 们 都 非常 简单 。 鉴 于 篇 幅 的 
原因 ， 这 里 就 不 再 详细 解释 另外 几 个 JSP 及 Servlet 。 感 兴趣 的 读者 可 以 
目 行 下 载 本 书 的 样 例 源 码 。 


12.4 使 用 jetty-maven-plugin 进 行 测试 


在 进行 Web 开 发 的 时 候 ， 我 们 总 是 无 法 避免 打开 浏览 器 对 应 用 进行 
测试 ， 比 如 为 了 验证 程序 功能 、 验 证 页 面 布局 ， 尤 其 是 一 些 与 页 面相 
关 的 特性 ， 手 动 部 署 到 Web 容 器 进行 测试 似乎 是 唯一 的 方法 。 近 年 来 出 
现 了 很 多 自动 化 的 Web 测 试 技术 如 Selenium， 它 能 够 录制 Web 操 作 ， 生 
成 各 种 语言 脚本 ， 然 后 自动 重复 这 些 操作 以 进行 测试 。 应 该 说 ， 这 类 
技术 方法 是 未 来 的 趋势 ， 但 无 论 如 何 ， 手 动 的、 亲眼 比 对 验证 的 测试 
是 无 法 被 完全 蔡 代 的 。 测 试 Web 页 面 的 做 法 通常 是 将 项 目 打包 并 部 署 到 
Web 容 器 中 ， 本 节 介绍 如 何 使 用 jetty-maven-plugin， 以 使 这 些 步骤 更 为 
便捷 。 


在 介绍 jetty-maven-plugin 之 前 ， 笔 者 要 强调 一 点 ， 虽 然 手 动 的 Web 
页 面 测 弃 是 必 不 可 少 的 ， 但 这 种 方法 绝 不 应 该 被 滥用 。 现 实 中 着 见 的 
情况 是 ， 很 多 程序 员 即 使 修改 了 一 些 较 底层 的 代码 〈《 如 数据 库 访问 、 
业务 逻辑 ， ，， 痢 会 习惯 性 地 打开 浏览 器 测试 整个 应 用 ， 这 往往 古 没 有 
必要 的 。 可 以 用 单元 测试 覆盖 的 代码 就 不 应 该 依赖 于 Web 页 面 测试 ， 且 
不 说 页 面 测试 更 加 耗 时 耗 力 ， 这 种 方式 还 无 法 目 动 化 ， 更 别提 重复 性 
T ° 因此 Web 页 面 测试 应 该 仅 限 于 页 面 的 层次 ， 例 如 JSP、CSS、 
JavaScript 的 修改 ， 其 他 代码 修改 (如 数据 访问 ) ， 请 编写 单元 测试 。 


传统 的 Web 测试 方法 要 求 我 们 编译 、 测 试 、 打 包 及 部 署 ， 这 往往 会 
消耗 数 10 秒 至 数 分 钟 的 时 间 ，jetty-maven-plugin 能 够 帮助 我 们 节省 时 
间 ， 它 能 够 周期 性 地 检查 项 目 内 容 ， 发 现 变 更 后 目 动 更 新 到 内 转 的 
Jetty Web 容 器 中 。 换 句 话 说 ， 它 帮 我 们 省 去 了 打包 和 部 署 的 步 又 。 
jetty-maven-plugin gk DIR HESL T Maven yi A HRM o CEI E 
情况 下 ， 我 们 只 需要 直接 在 IDE 中 修改 源码 ，IDE 能 够 执行 目 动 编译 ， 
jetty-maven-plugin 发 现 编译 后 的 文件 变化 后 ， 目 动 将 其 更 狐 到 Jetty 容 
硕 ， 这 时 就 可 以 直接 测试 Web 页 面 了 。 


使 用 jetty-maven-plugin 十 分 傈 单 。 指 定 该 插件 的 坐标 ， 并 且 稍 加 配 
置 即 可 ， 见 代码 清单 12-13。 


代码 清单 12-13 ”配置 jetty-maven-plugin 


<plugin > 
<groupId >org.mortbay. jetty < /groupld > 
<artifactId >jetty-maven-plugin < /artifactId> 
<version >7,1.6.v20100715 < /version > 
Seconds >10 < /scanIntervalSeconds > 
test mte at 


jetty-maven-plugin 并 不 是 官方 的 Maven 揪 件 ， 它 的 groupId 是 
org.mortbay.jetty， 上 述 代 码 中 使 用 了 Jetty 7 的 最 新 版 本 。 在 该 插件 的 配 
置 中 ，scanIntervalSeconds 顾 名 思 义 表示 该 插件 扫 摘 项 目 变更 的 时 间 间 
隔 ， 这 里 的 配置 是 每 隔 10 秒 。 需 要 注意 的 是 ， 如 果 不 进 行 配置 ， 该 元 


素 的 默认 值 是 0， 表 示 不 扫描 ， 用 户 也 就 失去 了 所 谓 的 自动 化 热 部 署 的 
功能 。 上 壕 代 码 中 webappConfig 元 素 下 的 contextPath 表 示 项 目 部 署 后 的 
context path。 例 如 这 里 的 值 为 /test， 那 么 用 户 束 可 以 通过 
http://hostname: port/test/ 访 问 该 应 用 。 


下 一 步 启动 jetty-maven-plugin。 不 过 在 这 之 前 需要 对 settings.xml 做 
个 微小 的 修改 。 前 面 介 绍 过 ， 默 认 情 况 下 ， 只 有 
org.apache.maven.plugins 和 org.codehaus.mojo 两 个 groupId 下 的 插件 才 支 
持 人 简化 的 命令 行 调用 ， 即 可 以 运行 mvn help: system, {Hmvn jetty: run 
就 不 行 了 。 因 为 maven-help-plugin 的 groupId 是 
org.apache.maven.plugins, fi} jetty-maven-plugin#) groupIdz= 
org.mortbay.jetty ° 为 了 能 在 命令 行 直接 运行 mvn jetty: run， 用 户 需 要 
配置 settings.xml 如 下 : 


¢settings > 
<pluginGroups > 
<pluginGroup >org.mortbay. jetty < /pluginGroup > 
< /pluginGroups > 


< / settings > 


现在 可 以 运行 如 下 命令 启动 jetty-maven-plugin: 


S mvn jetty:run 


jetty-maven-plugin 会 局 动 Jetty， 并 且 默 认 监 听 本 地 的 8080 端 口 ， 并 
将 当前 项 目 部 署 到 容 需 中 ， 同 时 它 还 会 根据 用 户 配置 扫 摘 代码 改动 。 


如 琳 布 望 使 用 其 他 端口 ， 可 以 深 加 jetty.port 参 数 。 例 如 : 


现在 束 可 以 打开 浏览 器 通过 地 址 http://localhost: 9999/test/ 测 斌 应 
用 了 。 要 停止 Jetty， 只 需要 在 命令 行 输入 Ctrl+C 即 可 。 


启动 Jetty 之 后 ， 用 户 可 以 在 IDE 中 修改 各 类 文件 ， 如 JSP、 
HTML 、CSS、JavaScript 甚 至 是 Java 类 。 只 要 不 是 修改 类 名 、 方 法 名 等 
较 大 的 操作 ，jetty-maven-plugin 都 能 够 扫描 到 变更 并 正确 地 将 变化 更 新 
至 Web 容 器 中 ， 这 无 颖 在 很 大 程度 上 帮助 了 用 户 实现 快速 开发 和 测试 。 


上 面 的 内 容 仅 仅 展示 了 jetty-maven-plugin 最 核心 的 配置 点 ， 如 果 有 
需要 ， 还 可 以 自 定 义 web.xml 的 位 置 、 项 目 alass 文 件 的 位 置 、web 资 源 
目录 的 位 置 等 信息 。 用 户 还 能 够 以 WAR 包 的 方式 部 署 项 目 ， 其 至 在 
Maven 的 生命 周期 中 风 入 jetty-maven-plugin。 例 如 ， 先 启动 Jetty 容 器 并 
部 署 项 目 ， 然 后 执行 一 些 集成 测试 ， 最 后 停止 容器 。 有 兴趣 进一步 研 
究 的 读者 可 以 访问 该 页 面 : 


http://wiki.eclipse.org/Jetty/Feature/Jetty_Maven_Plugin ° 


12.5 “使 用 Cargo 实 现 自动 化 部 署 


Cargo 是 一 组 帮助 用 户 操 作 Web 容 右 的 工具 ， 它 能 够 帮助 用 户 实 现 
目 动 化 部 署 ， 而 且 它 几乎 文 持 所 有 的 Web 容 器 ， 如 Tomcat > JBoss ` 
Jetty 和 Glassfish 等 。Cargo 通 过 cargo-maven2-plugin 提 供 了 Maven 集 成 ， 
Maven 用 户 可 以 使 用 该 插件 将 Web 项 目 部 署 到 Web 容 锅 中 。 虽 然 cargo- 
maven2-plugin 和 jetty-maven-plugin 的 功能 看 起 来 很 相似 ， 但 它们 的 目 
的 是 不 同 的 ，jetty-maven-plugin 主 要 用 来 帮助 日 常 的 快速 开发 和 测 
试 ， 而 cargo-maven2-plugin 主 要 服务 于 目 动 化 部 署 。 例 如 专门 的 测试 
人 员 只 需要 一 条 简单 的 Maven 命 令 ， 束 可 以 构建 项 目 并 部 署 到 Web 容 
锅 中 ， 然 后 进行 功能 测试 。 本 节 以 Tomcat 6 为 例 ， 介 绍 如 何 目 动 化 地 
将 Web 应 用 部 署 至 本 地 或 远程 Web 容 器 中 。 


12.5.1 foe BAT Webs aS 


Cargo 文 持 两 种 本 地 部 署 的 方式 ， 分 别 为 standalone 模 式 和 existing 模 
式 。 在 standalone 模 式 中 ，Cargo 会 从 Web 容 絮 的 安 效 目录 复制 一 份 配置 
到 用 户 指 定 的 目录 ， 然 后 在 此 基础 上 部 署 应 用 ， 每 次 重新 构建 的 时 
候 ， 这 个 目录 都 会 咎 清空 ， 所 有 配置 被 重新 生成 。 而 在 existing 模 式 
中 ， 用 户 需 要 指定 现 有 的 Web 容 器 配置 目录 ， 然 后 Cargo 会 直接 使 用 这 
些 配置 并 将 应 用 部 署 到 其 对 应 的 位 置 。 代 码 清单 12-14 展 示 了 standalone 
模式 的 配置 样 例 。 


代码 清单 12-14 ”使 用 standalone 模 式 部 署 应 用 至 本 地 Web 容 器 


<plugin > 
<groupId >org.codehaus. cargo < /grouplId > 
<artifactId >cargo-maven2-plugin < /artifactId> 
<version>1.0</version > 
< configuration > 
<container > 


<containerId >tomcat6x < /containerId > 
<home >D: \cmd \apache-tomcat-6.0.29 < /home > 

< /container > 

< configuration > 
< type > standalone < /type > 
< home > $ {project.build.directory}/tomcatóx < /home > 

< /configuration > 

< /configuration > 
< /plugin> 


cargo-maven2-plugin 的 groupId 是 org.codehaus.cargo， 这 不 属于 官方 
的 两 个 Maven 插 件 groupId， 因 此 用 户 需 要 将 其 添加 到 settings.xml 的 


pluginGroup 元 素 中 以 方便 命令 行 调用 。 


上 述 cargo-maven2-plugin 的 具体 配置 包括 了 container 和 configuration 
两 个 元 素 ，configuration 的 子 元素 type 表 示 部 署 的 模式 (这 里 是 
standalone) 。 与 之 对 应 的 ，configuration 的 home 子 元 素 表示 复制 容器 配 
置 到 什么 位 置 ， 这 里 的 值 为 $ {project.build.directory}/tomcat6x， 表 示 
构建 输出 目录 ， 即 target/ 下 的 tomcat6x 子 目录 。container 元 素 下 的 
containerld#é7 AeA, home tR AAA a LE SK o ET IAB 
置 ，Cargo 会 从 D: \cmd\apache-tomcat-6.0.29 日 录 下 复制 配置 到 当前 项 
目的 target/tomcat6x/ 目 录 下 。 


现在 ， 要 让 Cargo 启 动 Tomcat 并 部 署 应 用 ， 只 需要 运行 : 


以 account-web 为 例 ， 现 在 就 可 以 直接 访问 地 址 的 账户 注册 页 面 趾 
ye 


默认 情况 下 ，Cargo 会 让 Web 容 屁 监 昕 8080 端 口 。 可 以 通过 修改 
Cargo 的 cargo.servlet.port 属 性 来 改变 这 一 配置 ， 如 代码 祖 单 12-15 所 示 。 


代码 清单 12-15 “更改 Cargo 的 Servlet 监 听 端 口 


<plugin > 
<groupIid >org. codehaus. cargo < /groupld > 
<artifactid >cargo-maven2-plugin< /artifactId > 
<version >1.0 < /version > 
< configuration > 
<container > 
<containerid >tomcat6x < /containerId > 
<home >D: \cmd \apache-tomcat -6.0.29 < /home > 
< /container > 
<configuration > 
< type >standalone < /type > 
<home > $ {project. build. directory}/tomcat6x < /home > 
< properties > 
<cargo.servlet.port >8081 < /cargo. servlet.port > 
< /properties > 
< /configuration > 
< /configuration > 
< /plugin > 


要 将 应 用 直接 部 署 到 现 有 的 Web 容 器 下 ， 需 要 配置 Cargo 使 用 
existing 模 式 ， 如 代码 清单 12-16 所 示 。 


代码 清单 12-16 ”使 用 existing 模 式 部 署 应 用 至 本 地 Web 容 器 


<plugin > 
<groupId >org. codehaus. cargo < /groupId > 
<artifactid >cargo-maven2-plugin < /artifactid > 
<version>1.0</version> 
<configuration > 
< container > 
<containeriId > tomcat6x < /containerId > 
<home >D: \cmd \apache-tomcat-6.0.29 < /home > 
< /container > 
< configuration > 
< type >existing < /type > 
<home >D: \cmd \apache-tomcat-6.0.29 < /home > 
< /configuration > 
< /configuration > 
< /plugin > 


上 述 代 码 中 configuration 元 素 的 type 子 元 素 的 值 为 existing， 而 对 应 
的 home 子 元 素 表 示 现 有 的 Web 容 器 目录 ， 基 于 该 配置 运行 mvn cargo: 


start 之 后 ， 便 能 够 在 Tomcat 的 webapps 子 目 孙 看 到 被 部 署 的 Maven 项 
H o 


[1] 地 址 为 http:localhost : 8080/account-web-1.0.0- 
SNAPSHOT/signup.jsp ° 


12.5.2 be picfwebs 4s 


除了 让 Cargo 直 接管 理 本 地 Web 容 句 然 后 部 署 应 用 之 外 ， 也 可 以 让 
Cargo 部 署 应 用 至 远程 的 正在 运行 的 Web 容 器 中 。 当 然 ， 前 提 十 拥有 该 
容 郁 的 相应 管理 员 权 限 。 相 关 配 置 如 代码 铺 单 12-17 所 示 。 


代码 清单 12-17 部 署 应 用 至 远程 Web 容 器 


<plugin> 


<grou ete > org. codehaus. cargo < /grouplId > 
<artifactId >cargo-ma wend—p ugin< /artifactId > 


<version >1.0 < /version > 
< configuration > 
<container > 
containerlId > tomcat6x < /containerId 
< type > remote < /type > 
< fcontainer > 
<configuration > 
< type >runtime < /type > 
<properties > 
< cargo. remote. username >admin < /cargo. remote. username > 
< cargo. remote. password > admini23 < /cargo. remote. password > 
<cargo. tomcat.manager.url >http://localhost :8080 /manager < /car- 
go.tomcat.manager.url > 
< /properties > 
< /configuration > 
</configuration > 


< /plugin > 


对 于 远程 部 署 的 方式 来 说，container 元 素 的 type 子 元 素 的 值 必须 为 
remote。 如 有 果 不 显 式 指定 ，Cargo 会 使 用 殉 认 值 installed， 并 村 找 对 应 的 
容器 安装 目 孙 或 者 安装 包 ， 对 于 远程 部 署 方式 来 说 ， 安 装 目 录 或 者 安 
装 包 是 不 需要 的 。 上 述 代 码 中 configuration 的 type 子 元 素 值 为 runtime， 


ZR BME Ao, MERA ACE. Me 
依赖 于 一 个 已 运行 的 容器 。properties 元 素 用 来 声明 一 些 容器 热 部 署 相 
天 的 配置 。 例 如 ， 这 里 的 Tomcat 6 就 需要 提供 用 户 名 、 密 码 以 及 管理 地 
址 。 需 要 注意 的 是 ， 这 部 分 配置 元 素 对 于 所 有 容器 来 说 不 是 一 致 的 ， 
读者 需要 查阅 对 应 的 Cargo 文 档 。 


有 了 上 述 配置 后 ， 就 可 以 让 Cargo 部 署 应 用 了 “。 运 行 命令 如 下 : 


S mvn cargo:redeploy 


WRAP OARE SS RIVA, Cargomsc ht lek, Aa 


由 于 目 动 化 部 团 本 身 束 不 古人 简单 的 事情 ， 再 加 上 Cargo 要 兼容 各 种 
不 同类 型 的 Web 容 器 ， 因 此 cargo-maven2-plugin 的 相关 配置 会 显得 相对 
复 洒 ， 这 个 时 候 完 善 的 文档 束 显 得 尤为 重要 。 如 果 想 进一步 了 解 
Cargo， 可 访问 http:/cargo.codehaus.org/Maven2+plugin ° 


12.6 zh% 


本 草 介 绍 的 是 用 Maven 管 理 Web 项 目 ， 因 此 首先 讨论 了 Web 项 目的 
基本 结构 ， 然 后 分 析 实 现 了 本 书 至 景 案例 的 最 后 两 个 模块 :account- 
service 和 account-web， 其 中 后 者 十 一 个 典型 的 Web 模 块 。 开 发 Web 项 
目的 时 候 ， 大 家 往往 会 使 用 热 部 署 来 实现 快速 的 开发 和 测试 ，jetty- 
maven-plugin 可 以 帮助 实现 这 一 目标 。 本 章 最 后 讨论 的 是 目 动 化 部 
敬 ， 这 一 技术 的 主角 是 Cargo， 有 了 它 ， 可 以 让 Maven 目 动 部 署 应 用 至 
本 地 和 远程 Web 容 器 中 。 


第 13 草 ”版 本 管理 

本 章 内 容 

- 何 为 版 本 管理 

-Maven 的 版 本 号 定义 约定 

主干、 标签 与 分 支 

-自动 化 版 本 发 布 

自动 化 创建 分 文 

.GPG 签 名 

-小结 


一 个 健康 的 项 目 通 常 有 一 个 长 期 、 合理 的 版 本 演变 过 程 。 例 如 
JUnit 有 3.7、3.8、3.8.1、3.8.2、4.0、4.1 等 版 本 。Maven 本 身 的 版 本 也 
比较 多 ， 如 最 早 的 Maven 1; 目前 使 用 最 广泛 的 Maven 2 有 2.0.9、 
2.0.10、2.1.0、2.2.0、2.2.1 等 各 种 版 本 ; 而 最 新 的 Maven 3 则 拥有 3.0- 
alpha-1、3.0-alpha-2、3.0-alpha-7、3.0-beta-1 等 版 本 。 除 了 这 些 对 外 发 
布 的 版 本 之 外 ，6.5 节 还 介绍 了 Maven 特 有 的 快照 版 本 的 概念 。 这 些 版 
本 中 的 每 个 数字 代表 了 什么 ? alpha、beta 是 什么 意思 ? 快照 版 和 发 布 


版 的 区 别 是 什么 ? 我 们 应 该 如 何 科学 地 管理 目 己 的 项 目 版 本 ? 本 章 将 


会 详细 解答 这 些 问 题 。 


阅读 本 章 的 时 候 还 需要 分 清 版 本 管理 (Version Management) 和 版 
本 控制 (Version Control) 的 区 别 。 版 本 管理 是 指 项 目 整体 版 本 的 演变 
过 程 管 理 ， 如 从 1.0-SNAPSHOT 到 1.0， 再 到 1.1-SNAPSHOT。 版 本 控 
制 是 指 借助 版 本 控制 工具 (如 Subversion) 追踪 代码 的 每 一 个 变更 。 本 
章 重点 讲述 的 是 版 本 管理 ， 但 是 读者 将 会 看 到 ， 版 本 管理 通常 也 会 涉 
及 一 些 版 本 控制 系统 的 操作 及 概念 。 请 在 阅读 的 时 候 特 别 留意 这 两 者 
的 关系 和 区 别 。 


13.1 何 为 版 本 管理 


6.5 市 谈 到 ， 为 了 方便 团队 的 合作 ， 在 项 目 开发 的 过 程 中 ， 大 家 部 
应 该 使 用 快照 版 本 ，Maven 能 够 很 智能 地 处 理 这 种 特殊 的 版 本 ， 解 析 
项 目 各 个 模块 最 新 的 “快照 ”。 快 照 版 本 机 制 促进 团队 内 部 的 交流 ， 但 
是 当 项 目 需要 对 外 发 布 时 ， 我 们 显然 需要 提供 非常 稳定 的 版 本 ， 使 用 
该 版 本 应 当 永 远 只 能 够 定位 到 唯一 的 构件 ， 而 不 是 像 快照 版 本 那样 ， 
定位 的 构件 随时 可 能 发 生变 化 。 对 应 地 ， 我 们 称 这 类 稳定 的 版 本 为 发 
布 版 。 项 目 发 布 了 一 个 版 本 之 后 ， 殊 进入 下 一 个 开发 阶段 ， 项 目 也 整 
目 然 转换 到 新 的 快照 版 本 中 。 


版 本 管理 关心 的 问题 之 一 就 是 这 种 快照 版 和 发 布 版 之 间 的 转换 。 
项 目 经 过 了 一 段 时 间 的 1.0-SNAPSHOT 的 开发 之 后 ， 在 某 个 时 刻 发 布 
了 1.0 正 式 版 ， 然 后 项 目 义 进入 了 1.1-SNAPSHOT 的 开发 ， 这 个 版 本 可 
能 添加 了 一 些 有 趣 的 特性 ， 然 后 在 某 个 时 刻 发 布 1.1 正 式 版 。 项 目 接 闭 
进入 1.2-SNAPSHOT 的 开发 。 由 于 快照 对 应 了 项 目的 开发 过 程 ， 因 此 
往往 对 应 了 很 长 的 时 间 ， 而 正式 版 本 对 应 了 项 目的 发 布 ， 因 此 仅仅 代 
表 某 个 时 刻 项 目的 状态 ， 如 图 13-1 所 示 。 


图 13-1 快照 版 和 发 布 版 之 间 的 转换 


理想 的 发 布 版 本 应 当 对 应 了 项 目 某 个 时 刻 比较 稳定 的 状态 ， 这 包 
插 源 代码 的 状态 以 及 构建 的 状态 ， 因 此 这 个 时 候 项 目的 构建 应 当 满 足 
以 下 的 条 件 : 


“所 有 目 动 化 测试 应 当 全 部 通过 。 唉 无 疑问 ， 失 败 的 测试 代表 了 需 
要 修复 的 问题 ， 因 此 发 布 版 本 之 前 应 该 确保 所 有 测试 都 能 得 以 正确 执 


行 。 


项目 没 有 配置 任何 快照 版 本 的 依赖 。 快 照 版 本 的 依赖 意味 着 不 同 
时 间 的 构建 可 能 会 引入 不 同 内 容 的 依赖 ， 这 显然 不 能 你 证 多 次 构建 能 
够 生成 同样 的 结果 。 


项目 没 有 配置 任何 快照 版 本 的 插件 。 快 照 版 本 的 插件 配置 可 能 会 
在 不 同时 间 引 入 不 容 内 容 的 Maven 插 件 ， 从 而 影响 Maven 的 行为 ， 破 
坏 构 建 的 稳定 性 。 


项目 所 包含 的 代码 已 经 全 部 提交 到 版 本 控制 系统 中 。 项 目 已 经 发 
布 了 ， 可 源 代码 却 不 在 版 本 控制 系统 中 ， 甚 至 丢失 了 。 这 意味 着 项 目 
丢失 了 某 个 时 刻 的 状态 ， 因 此 这 种 情况 必须 避免 ， 版 本 发 布 的 时 候 必 
须 确保 所 有 的 源 代码 都 已 经 提交 了 。 


只 有 上 壕 条 件 都 满足 之 后 ， 才 可 以 将 快照 版 本 更 新 为 发 布 版 本 ， 
例如 将 1.0-SNAPSHOT 更 新 为 1.0， 然 后 生成 版 本 为 1.0 的 项 目 构件 。 


不 过 这 里 还 缺少 一 步 关 键 的 版 本 控制 操作 。 如 采 你 了 解 任何 一 种 

版 本 控制 工具 ， 如 Subversion， 那 就 应 该 能 想到 项 目 发 布 与 标签 

(Tag) 的 关系 。 版 本 控制 系统 记录 代码 的 每 一 个 变化 ， 通 常 这 些 变化 
都 被 维护 在 主干 (Trunk) 中 ， 但 是 当 项 目 发 布 的 时 候 ， 开 发 人 员 就 应 
该 使 用 标签 记录 这 一 特殊 时 刻 项 目的 状态 。 以 Subversion 为 例 ， 日 第 的 
变更 维护 在 主干 中 ， 包 含 各 种 源码 版 本 r1、r2、...、r284、...。 要 找到 
某 个 时 刻 的 项 目 状 态 会 比较 磋 烦 ， 而 使 用 标签 束 可 以 明确 地 将 某 个 源 
码 版 本 (也 就 是 项 目 状态 ) 从 主干 中 标记 出 来 ， 放 到 单独 的 位 置 ， 这 
样 在 之 后 的 任何 时 刻 ， 我 们 都 能 够 快速 地 得 到 发 布 版 本 的 源 代 码 ， 从 
而 能 够 比较 各 个 版 本 的 差异 ， 甚 至 重新 构建 一 个 同样 版 本 的 构件 。 


因此 ， 将 项 目的 快照 版 本 更 新 至 发 布 版 本 之 后 ， 应 当 再 执行 一 次 
Maven 构 建 ， 以 确保 项 目 状 态 是 健康 的 。 然 后 将 这 一 变更 提交 到 版 本 
控制 系统 的 主干 中 。 接 着 再 为 当前 主干 的 状态 打上 标签 。 以 Subversion 
为 例 ， 这 几 个 步骤 对 应 的 命令 如 下 : 


Smvn clean install 
$svn copy -m "tag release 1.0" \ 
https://svn. juvenxu. com/project /trunk 、 


https://svn. juvenxu. com/project /tags/1.0 


至 此 ， 一 个 版 本 发 布 的 过 程 完 成 了 。 接 下 来 要 做 的 就 是 更 新 发 布 
版 本 至 新 的 快照 版 本 ， 如 从 1.0 到 1.1-SNAPSHOT ° 


13.2 ”Maven 的 版 本 号 定义 约定 


到 目前 为 止 ， 读 者 应 该 已 经 清楚 了 解 了 快照 版 和 发 布 版 的 区 别 。 
现在 再 深入 看 一 下 1.0、1.1、1.2.1、3.0-beta 这 样 的 版 本 号 后 面 又 遵循 
了 怎样 的 约定 。 了 人 解 了 这 样 的 约定 之 后 ， 就 可 以 正确 地 为 自己 的 产品 
或 者 项 目 定义 版 本 号 ， 而 你 的 用 户 也 能 了 解 到 隐藏 在 版 本 号 中 的 信 


F o 


看 一 个 实际 的 例子 ， 这 里 有 一 个 版 本 : 
1.3.4-beta-2 
这 往往 表示 了 该 项 目 或 产品 的 第 一 个 重大 版 本 的 第 三 个 次 要 版 本 
的 第 四 次 增 量 版 本 的 beta-2 里 程 碑 。 很 抛 口 ? 那 一 个 个 分 开 解 
RE: “1” 表 示 了 该 版 本 是 第 一 个 重大 版 本 ; “3” 表 示 这 是 基于 重大 版 本 
的 第 三 个 次 要 版本; “4” 表 示 该 次 要 版 本 的 第 四 个 增 量 ， 最 后 的 “beta- 
2” 表 示 该 增 量 的 某 一 个 里 程 牌 。 


也 就 是 说 ，Maven 的 版 本 号 定义 约定 是 这 样 的 : 


< 主 版 本 >.< 次 版 本 >.< 增 量 版 本 >-< 里 程 碑 版 本 > 


主 版 本 和 次 版 本 之 间 ， 以 及 次 版 本 和 增 量 版 本 之 间 用 点 号 分 隔 ， 
里 程 碑 版 本 之 前 用 连 字 号 分 隔 。 下 面 解释 其 中 每 一 个 部 分 的 意义 : 


ERMA: 表示 了 项 目的 重大 架构 变更 。 例 如 ，Maven 2 和 Maven 1 
EEI; Struts 1 和 Struts 2 采用 了 不 同 的 架构 ; JUnit 4 较 JUnit 3 增加 
了 标注 支持 。 


:次 版 本 表示 较 大 范围 的 功能 增加 和 变化 ， 及 Bug 修 复 。 例 如 
Nexus 1.5 较 1.4 添 加 了 LDAP 的 支持 ， 并 修复 了 很 多 Bug,， 但 从 总 体 架 
构 来 说 ， 没 有 什么 变化 。 


HERA: 一般 表示 重大 Bug 的 修复 ， 例 如 项 目 发 布 了 1.4.0 版 本 
之 后 ， 发 现 了 一 个 影响 功能 的 重大 Bug， 则 应 该 快速 发 布 一 个 修复 了 
Bug 的 1.4.1 版 本 。 


里程 碑 版 本 顾名思义 ， 这 往往 指 某 一 个 版 本 的 里 程 碑 。 例 如 ， 
Maven 3 已 经 发 布 了 很 多 里 程 碑 版 本 ， 如 3.0-alpha-1、3.0-alpha-2、3.0- 
beta-1 等 。 这 样 的 版 本 与 正式 的 3.0 相 比 ， 往 往 表 示 不 是 非常 稳定 ， 还 
需要 很 多 测试 。 


需要 注意 的 是 ， 不 古 每 个 版 本 号 都 必须 拥有 这 四 个 部 分 。 一 般 来 
说 ， 主 版 本 和 次 版 本 都 会 声明 ， 但 增 量 版 本 和 里 程 碑 就 不 一 定 了 。 例 
如 ， 像 3.8 这 样 的 版 本 没有 增 量 和 里 程 碑 ，2.0-beta-1 没 有 增 量 。 但 我 们 
不 会 看 到 有 人 省略 次 版 本 ， 简 单 地 给 出 主 版 本 显然 是 不 够 的 。 


当 用 户 在 声明 依赖 或 插件 未 声明 版 本 时 ，Maven 束 会 根据 上 述 的 
版 本 号 约定 目 动 解析 最 新 版 本 。 这 个 时 候 整 需 要 对 版 本 号 进行 排序 。 


对 于 主 版 本 、 次 版 本 和 增 量 版 本 来 说 ， 比 较 是 基于 数字 的 ， 因 此 


1.5>1.4>1.3.11>1.3.9。 而 对 于 里 程 碑 版 本 ，Maven 则 只 进行 简单 的 字 


串 比 较 ， 因 此 会 得 到 1.2-beta-3>1.2-beta-11 的 结果 。 这 一 点 需要 留意 


w 
=] 
Ww 


13.3 ER MSSM 


使 用 版 本 控制 工具 时 我 们 都 会 遇 到 主干 (trunk) 


` 标签 (tag) 和 
branch (DX) 的 概念 。13.1 节 已 经 涉及 了 主干 与 标签 。 这 里 再 详细 将 
这 几 个 概念 曾 述 一 下 ， 因 为 理解 它们 是 理解 Maven 版 本 管理 的 基础 。 


ET: 项 目 开发 代码 的 主体 ， 是 从 项 目 开始 直到 当前 都 处 于 活动 
的 状态 。 从 这 里 可 以 获得 项 目 最 新 的 源 代 码 以 及 几乎 所 有 的 变更 历 
Eo 


DL: 从 主干 的 某 个 点 分 离 出 来 的 代码 拷贝 ， 


通 间 可 以 在 不 影响 
主干 的 前 提 下 在 这 里 进行 重大 Bug 的 修复 ， 或 者 做 一 些 实验 性 质 的 开 
发 。 如 果 分 文 达到 了 预期 的 目的 ， 通 常 发 生 在 这 里 的 变更 会 被 合并 
(merge) 到 主干 中 。 


标签 : 用 来 标识 主干 或 者 分 文 的 某 个 点 的 状态 ， 以 代表 项 目的 某 
个 稳定 状态 ， 这 通常 束 是 版 本 发 布 时 的 状态 。 


本 书 采 用 Subversion 作 为 版 本 控制 系统 ， 如 有 果 对 上 述 概 念 不 清晰 ， 
请 参考 开放 的 《Subversion 与 版 本 控制 》 (http://svnbook.red- 
bean.com/) 一 书 。 


使 用 Maven 管 理 项 目 版 本 的 时 候 ， 也 涉及 了 很 多 的 版 本 控制 系统 
操作 。 下 面 束 以 一 个 实际 的 例子 来 介绍 这 些 操作 是 如 何 执行 的 。 


图 13-2 下 方 最 长 的 箭头 表示 项 目的 主干 ， 项 目 最 初 的 版 本 是 1.0.0- 
SNAPSHOT， 经 过 一 段 时 间 的 开发 后 ，1.0.0 版 本 发 布 ， 这 个 时 候 融 需 
要 打 一 个 标签 ， 图 中 用 一 个 长 条 表示 。 然 后 项 目 进 入 1.1.0-SNAPSHOT 
状态 ， 大 量 的 开发 工作 都 完成 在 主干 中 ， 添 加 了 一 些 新 特性 并 修复 了 
很 多 Bug 之 后 ， 项 目 1.1.0 发 布 ， 同 样 ， 这 时 候 需 要 打 另 一 个 标签 。 发 
布 过 后 ， 项 目 进 入 1.2.0-SNAPSHOT 阶 段 ， 可 这 个 时 候 用 户 报告 1.1.0 版 
本 有 一 个 重大 的 Bug， 需 要 尽快 修复 ， 我 们 不 能 在 主干 中 修 Bug， 因 为 
主干 有 太 多 的 变化 ， 无 法 在 短 时 间 内 测试 完毕 并 发 布 ， 我 们 也 不 能 停 
止 1.2.0-SNAPSHOT 的 开发 ， 因 此 这 时 候 可 以 基于 1.1.0 创 建 一 个 1.1.1- 
SNAPSHOT 的 分 文 ， 在 这 里 进行 Bug 修 复 ， 然 后 为 用 户 发 布 一 个 1.1.1 
增 量 版 本 ， 同 时 打上 标签 。 当 然 ， 还 不 能 乐 了 把 Bug 修 复 涉 及 的 变更 
合并 到 1.2.0-SNAPSHOT 的 主干 中 。 主 干 在 开发 一 段 时 间 之 后 ， 发 布 
1.2.0 版 本 ， 然 后 进入 到 新 版 本 1.3.0-SNAPSHOT 的 开发 过 程 中 。 


1.1.1-SNAPSHOT 


标签 


1.0.0-SNAPSHOT 1.1.0-SNAPSHOT 1.2.0-SNAPSHOT 1.3.0-SNAPSHOT 


图 13-2 主干、 标签 和 分 支 与 项 目 版 本 的 关系 


图 13-2 展 示 的 是 一 个 典型 的 项 目 版 本 变化 过 程 ， 这 里 涉及 了 快照 
版 与 发 布 版 之 间 的 切换 、Maven 版 本 写 约 定 的 应 用 ， 以 及 版 本 控制 系 
统 主干 、 标 签 和 分 文 的 使 用 。 这 其 实 也 是 一 个 不 成 文 的 行业 标准 ， 理 
解 这 个 过 程 之 后 ， 不 仅 能 够 更 方便 地 学 习 开 源 项 目 ， 也 能 对 项 目的 版 
本 管理 更 加 标准 和 清晰 。 


13.4” 目 动 化 版 本 发 布 


本 对 前 儿 市 已 经 详细 介绍 了 版 本 发 布 时 所 需要 完成 的 工作 ， 读 者 
如 采 愿 意 ， 则 完全 可 以 手动 地 执行 这 些 操作 ， 检 查 是 否 有 未 提交 代 
码 、 是 否 有 快照 依赖 、 更 新 快照 版 至 发 布 版 、 执 行 Maven 构 建 以 及 为 源 
代码 打 标 签 等 。 事 实 上 ， 如 果 对 这 一 过 程 不 是 很 熟悉 ， 那 么 还 是 应 该 
一 步 一 步 地 操作 一 过， 以 得 到 最 直观 的 感受 。 


当 熟 悉 了 版 本 发 布 流程 之 后 ， 就 会 希望 借助 工具 将 这 一 流程 自动 
化 。Maven Release Plugin 束 提供 了 这 样 的 功能 ， 只 要 提供 一 些 必要 的 
言 息 ， 它 就 能 帮 我 们 完成 上 述 所 有 版 本 发 布 所 涉及 的 操作 。 下 面 介 绍 
如 何 使 用 Maven Release Plugin 发 布 项 目 版 本 。 


Maven Release Plugin 主 要 有 三 个 目标 ， 它 们 分 别 为 : 


release: prepare 准 备 版 本 发 布 ， 依 次 执行 下 列 操作 : 


四 检查 项 目 症 否 有 未 提交 的 代码 。 


四 检查 项 目 征 人 否 有 快照 版 本 依 顿 。 


四 根据 用 户 的 输入 将 快照 版 本 升级 为 发 布 版 。 


四 将 POM 中 的 SCM 信 息 更 新 为 标签 地 址 。 


目 基 于 修改 后 的 POM 执 行 Maven 构 建 。 
四 提交 POM 变 更 。 

四 基于 用 户 输 入 为 代码 打 标 签 。 

四 将 代码 从 发 布 版 升级 为 新 的 快照 版 。 
四 提交 POM 变 更 。 


‘release: rollback 回 退 release: prepare 所 执行 的 操作 。 将 POM 回 退 
至 release: prepare 之 前 的 状态 ， 并 提交 。 需 要 注意 的 是 ， 该 步骤 不 会 删 
除 release: prepare 生 成 的 标签 ， 因 此 用 户 需 要 手动 删除 。 


‘release: _ perform 执行 版 本 发 布 。 签 出 release: prepare 生 成 的 标签 
中 的 源 代 码 ， 并 在 此 基础 上 执行 mvn deploy 命 令 打包 并 部 署 构件 至 仓 
库 o 


要 为 项 目 发 布 版 本 ， 首 先 需 要 为 其 添加 正确 的 版 本 控制 系统 信 
息 ， 这 是 因为 Maven Release Plugin 需 要 知道 版 本 控制 系统 的 主干 、 标 
签 等 地 址 信息 后 才能 执行 相关 的 操作 。 一 般配 置 项 目的 SCM 信 息 如 代 
码 清单 13-1 所 示 。 


代码 清单 13-1 为 版 本 发 布 配置 SCM 信 息 


<project > 


< scm > 


<connection>scm:svn:http://192.1 ae. 1.103 /ap PP/ ‘crunk < /connection > 
GeveloperConnection >sem:svn:http /192 .168. /app/ trunk < /developerCon- 
nection > 
<url> http://192.168.1.103 /account /trunk < /url > 
scm>.. 
oject > 


代码 清单 13-1 中 的 connection 元 素 表 示 一 个 只 读 的 scm 地 址 ， 而 
developerConnection 元 素 表 示 可 写 的 scm 地 址 ，url 则 表示 可 以 在 浏 贤 絮 
中 访问 的 scm 地 址 。 为 了 能 让 Maven 识 别 ，connection 和 
developerConnection 必 须 以 sam 开头， 冒号 之 后 的 部 分 表示 版 本 控制 工 
具 类 型 (这 里 是 svn) ，Maven 还 支持 cvs、git 等 。 接 下 来 才 是 实际 的 
scm 地 址 ， 该 例 中 的 connection 使 用 了 http 协 议 ， 而 developerConnection 
则 由 于 涉及 写 操 作 ， 使 用 https 协 议 进行 了 保护 。 


该 配置 只 告诉 Maven 当 前 代码 的 位 置 (EF) ， 而 版 本 发 布 还 要 涉 
及 标签 操作 。 因 此 ， 还 需要 配置 Maven Release Plugin 告 诉 其 标签 的 基 
础 目录 ， 如 代码 清单 13-2 所 示 。 


代码 清单 13-2 ”配置 maven-release-plugin 提 供 标签 基础 日 如 


<plugin> 
<groupld >org.apache. maven. plugins < /groupId > 
<artifactId >maven-release-plugin < /artifactId > 
<version >2.0 </version> 
<configuration > 

< tagBase >https://192.168.1.103 /app/tags/< /tagBase > 

< /configuration > 

< /plugin > 


在 执行 release: prepare 之 前 还 有 两 个 注意 点 : 第 一 ， 系 统 必 须要 提 
供 svn 命 令 行 工 具 ，Maven 需 要 svn 命 令 行 工具 执行 相关 操作 ， 而 无 法 使 
用 图 形 化 的 工具 ， 如 TortoiseSVN; 第 二 ，POM 必 须 配置 了 可 用 的 部 署 
仓库 ， 因 为 release: perform 会 执行 deploy 操 作 将 构件 发 布 到 仓库 中 。 关 
于 如 何 配 置 部 署 仓库 可 参考 9.6.1 广 。 


一 切 整 缮 之 后 ， 在 项 目 根 目录 下 运行 如 下 命令 : 


$mvn release:prepare 


Maven Release Plugin 开 始 准备 发 布 版 本 ， 如 采 它 检测 到 项 目 有 未 
提交 的 代码 ， 或 者 项 目 有 快照 版 的 依赖 ， 则 会 提示 出 错 。 如 有 果 一 切 都 
没 问 题 ， 则 会 提示 用 户 输 入 想 要 发 布 的 版 本 号 、 标 等 的 名 称 以 及 新 的 
快照 版 本 号 。 例 如 : 


What is the ne 2lopment version for "App"? (com, juvenxu.mvnbook:app) 1.0.1- 


Whi oW deve k 
SNAPSHOT: :1.1.0-SNAPSHOT 


如 有 果 项 目的 artifactId 为 app， 发 布 前 的 版 本 为 1.0.0-SNAPSHOT， 则 
Maven Release Plugin 会 提示 使 用 发 布 版 本 号 1.0.0， 使 用 标签 名 称 app- 
1.0.0， 新 的 开发 版 本 为 1.0.1-SNAPSHOT。 如果 这 些 模式 值 正 是 你 想 要 
的 ， 直 接 按 Enter 键 即 可 ， 否 则 就 输入 想 要 的 值 再 按 Enter 键 ， 如 上 例 中 
为 新 的 开发 版 本 输入 了 值 1.1.0-SNAPSHOT ° 


基于 这 些 信 息 ，Maven Release Plugin 会 将 版 本 从 1.0.0-SNAPSHOT 
更 新 为 1.0.0， 并 更 新 SCM 地 址 http://192.168.1.103/app/trunk 至 
http://192.168.1.103/app/tags/app-1.0.0。 在 此 基础 上 运行 一 次 Maven 构 建 
以 防止 意外 的 错误 出 现 ， 然 后 将 这 两 个 变化 提交 ， 并 为 该 版 本 打上 标 
签 ， 标 签 地 址 是 http:/192.168.1.103/app/mtags/app-1.0.0。 即 tagBase 路 径 
加 上 标签 名 称 。 之 后 ，Maven Release Plugin 会 将 POM 中 的 版 本 信息 从 


1.0.0 升 级 到 1.1.0-SNAPSHOT 并 提交 © 


JE, release: prepare 的 工作 完成 。 如 有 果 这 时 你 发 现 了 一 些 问 题 ， 
PUM Ns PRC Es J, Ma DME release: rollback 命 令 回 退 发 
#fi, Maven Release Plugin 会 将 POM 的 配置 回 退 到 release: prepare 之 前 
的 状态 。 但 需要 注意 的 是 ， 版 本 控制 系统 中 的 标签 并 不 会 被 删除 ， 也 
就 是 说 ， 用 户 需 要 手动 执行 版 本 控制 系统 命令 删除 该 标签 。 


在 多 模块 项 目 中 执行 release: prepare 的 时 候 ， 默 认 maven-release- 
plugin 会 提示 用 户 设 定 每 个 模块 发 布 版 本 号 及 新 的 开发 版 本 号 。 例 如 ， 
如 果 在 account-parent 模 块 中 配置 正确 的 scm 信 息 之 后 进行 项 目 发 布 ， 就 
会 看 到 如 下 的 输出 : 


What is the release version for "Account Parent"? (com. juvenxu.mvnbook. account: 
account-parent) 1.0.0: 

What is the release version for "Account Email"? (com. juvenxu. mvnbook. account :ac- 
count-email) 1.0.0: : 

What is the release version for "Account Persist"? (com. juvenxu.mvnbook. account: 
account-persist)1.0.0:: 

What is the release version for "Account Captcha"? (com. juvenxu.mvnbook. account: 
account-captcha) 1.0.0: : 

What is the release version for "Account Service"? (com. juvenxu. mvnbook. account: 
account-service) 1.0.0: : 

What is the release version for "Account Web"? (com. juvenxu.mvnbook. account :ac- 
count-web) 1.0.0:: 

What is SCM release tag or label for “Account Parent"? (com. jJuvenxu.mvnbook. account :ac- 
count-parent) account-parent-1.0.0:: 

What is the new development version for "Account Parent"? (com. juvenxu.mvnbook. account : 
account-—parent) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Email"? (com. Juvenxu.mvnbook. account : 
account-email) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Persist"? (com. juvenxu.mvnbook. account : 
account-persist) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Captcha"? (com. juvenxu.mvnbook. account : 
account-captcha) 1.0.1-SNAPSHOT: : 

What is the new development version fo 
account-service) 1.0.1-SNAPSHOT: : 

What is the new development version for "Account Web"? (com. juvenxu.mvnbook. account :ac- 
count -web) 1.0.1-SNAPSHOT: : 


ry 


"Account Service"? (com. juvenxu.mvnbook. account : 


在 很 多 情况 下 ， 我 们 会 希望 所 有 模块 的 发 布 版 本 以 及 新 的 
SNAPSHOT 开 发 版 本 都 保持 一 怪 。 为 了 避免 重复 确认 ，maven-release- 
plugin 提 供 了 autoVersionSubmodules 参 数 。 例 如 运行 下 面 的 命令 后 ， 
maven-release-plugin 承 会 目 动 为 所 有 子 模块 使 用 与 父 模块 一 致 的 发 布 版 
本 和 新 的 SNAPSHOT 版 本 : 


Smvn release:prepare DautoVersionSubmodules =true 


如 果 检 查 下 来 release: prepare 的 结果 没有 问题 ， 标 答 和 新 的 开发 版 
本 都 是 正确 的 ， 可 以 执行 如 下 发 布 执行 命令 : 


$mvn release:perform 


该 命令 将 标签 中 的 代码 签 出 ， 执 行 mvn deploy 命 令 构建 刚才 准备 的 
1.0.0 版 本 ， 并 部 署 到 仓库 中 。 至 此 ， 版 本 1.0.0 正 式 发 布 完成 。 由 于 它 
已 经 被 部 署 到 了 Maven 仓 库 中 ， 其 他 人 可 以 方便 地 配置 对 它 的 依赖 。 


细心 的 读者 可 能 会 发 现 ， 如 果 你 所 发 布 项 目的 打包 类 型 为 jar， 在 
执行 release: perform 之 后 ， 不 仪 项 目的 主 构件 会 被 生成 并 发 布 到 仓库 
中 ， 基 于 该 主 构 件 的 -sources.jar 和 -javadoc.jar 也 会 生成 并 发 布 。 对 于 你 
的 用 户 来 说 ， 这 无 疑 是 非 弟 方便 的 ， 他 们 不 仅 能 够 下 载 你 的 主 构件 ， 
还 能 够 得 到 项 目的 源 公 和 Javadoc。 那 么 ，release: perform 是 怎样 生成 - 


Sources.jar 和 -javadoc.jar 的 呢 ? 


8.5 广 介绍 过 ， 所 有 Maven 项 目的 POM 都 继承 目 超 级 POM， 而 如 果 
打开 超级 POM， 束 能 发 现 如 代码 清单 13-3 所 示 内 容 。 


代码 清单 13-3 ”超级 POM 中 sources 和 javadoc 的 配置 


<profiles > 
<profile> 
<id>release-profile</id> 


<activation > 
<property > 
<name >performRelease < /name > 
<value >true < /value > 
< /property > 
< /activation > 


<build > 
<plugins > 
<plugin > 
<inherited >true < /inherited > 
<artifactId >maven-source-plugin < /artifactId> 
< executions > 
<execution > 
<id>attach-sources < /id> 
<goals > 
<goal >jar < /goal > 
< /goals > 
< /execution > 
< fexecutions > 
< /plugin > 
<plugin> 
<inherited >true < /inherited > 
<artifactId >maven-javadoc-plugin < /artifactId > 
<executions > 
< execution > 
<id>attach-javadocs < /id> 
<goals > 
<goal >jar < /goal > 
< /goals > 
< f/execution > 
< f/executions > 
< /plugin > 
<plugin > 
<inherited >true < /inherited > 
<artifactId >maven-deploy-plugin < /artifactId > 
<configuration > 
<updateReleaselnfo >true < /updateReleaselInfo > 
< /configuration > 
< /plugin > 
< /plugins > 
< /build> 
< /profile> 
< /profiles > 


超级 POM 中 定义 了 一 个 名 为 release-profile 的 Maven Profile, Profile 
是 指 一 段 在 特定 情况 下 被 激活 并 更 改 Maven 行 为 的 配置 ， 本 书后 续 会 
专门 的 章节 详细 阐述 。 这 里 看 到 activate 元 素 下 有 一 个 名 为 
performRelease、 值 为 true 的 属性 配置 ， 这 表示 当 Maven 运 行 时 ， 如 有 果 运 
行 环境 中 有 performRelease 属 性 且 值 为 true 的 时 候 ， 该 Profile 就 被 激活 。 
也 殉 是 说 ， 该 Profile 下 的 配置 会 得 到 应 用 。 那 么 ， 什 么 情况 下 Maven 运 
行 环境 中 会 有 名 为 performRelease、 值 为 true 的 属性 呢 ? 可 以 在 命令 行 指 
定 。 例 如 ; 


$ mvn clean install -DperformRelease =true 


但 是 ， 读 者 可 能 已 经 猜 到 了 ， 在 执行 release: perform 的 时 候 ， 
Maven Release Plugin 会 目 动 生成 值 为 true 的 performRelease 属 性。 这 时 ， 
超级 POM 中 的 release-profile 就 会 被 激活 。 


这 个 Profile 配 置 了 3 个 Maven 插 件 ，maven-sources-plugin 的 jar 目 标 
会 为 项 目 生 成 -source.jar 文 件 ，maven-javadoc-plugin 的 jar 目 标 会 为 项 目 
生成 -javadoc.jar 文 件 ， 而 maven-deploy-plugin 的 update-release-info 配 置 
则 会 在 部 署 的 时 候 更 新 仓库 中 的 元 数据 ， 告 诉 仓库 该 版 本 是 最 新 的 发 
布 版 。 每 个 插件 配置 中 值 为 true 的 inherited 元 素 则 表示 该 插件 配置 可 以 
被 子 POM 继 承 。 


在 日 常 的 快照 开发 过 程 中 ， 往 往 没 有 必要 每 次 都 生成 -source.jar 和 - 
javadoc.jar， 但 是 当 项 目 发 布 的 时 候 ， 这 些 文件 就 显得 十 分 重要 。 超 级 


POM 中 的 release-profile 就 是 为 了 这 种 情形 而 设计 的 。 需 要 注意 的 是 ， 
这 种 隐 式 的 配置 对 于 不 熟悉 Maven 的 用 户 来 说 可 能 会 显得 十 分 令 人 费 
解 ， 因 此 将 来 的 Maven 版 本 中 可 能 会 从 超级 POM 中 移 除 这 段 配置 ， 所 
以 如 果 用 户 希 望 在 发 布 版 本 时 上 自动 生成 -sources.jar 和 -javadoc.jar， 最 好 
还 是 在 目 己 的 POM 中 显 式 地 配置 这 些 插件 。 


13.5 目 动 化 创建 分 文 


13.4 节 介绍 了 如 何 使 用 Maven Release Plugin 自 动 化 版 本 发 布 ， 如 果 
回顾 一 下 图 13-2， 束 会 发 现 分 支 创 建 的 操作 还 没有 具体 涉及 。 本 市 就 继 
续 基 于 实际 的 样 例 讲 解 如 何 目 动 化 创建 分 文 。 


在 图 13-2 中 可 以 看 到 ， 在 正式 发 布 版 本 1.1.0 的 同时 ， 还 可 以 创建 一 
个 分 文 用 来 修复 将 来 这 个 版 本 可 能 遇 到 的 重大 Bug。 这 个 过 程 可 以 手工 
完成 ， 例 如 使 用 svn copy 损 作 将 主干 代码 复制 到 一 个 名 为 1.1.x 的 分 文 
中 ， 然 后 修改 分 文中 的 POM 文 件 ， 升 级 其 版 本 为 1.1.1-SNAPSHOT， 这 
会 涉及 很 多 Subversion 操 作 ° 


使 用 Maven Release Plugin 的 branch 目 标 ， 它 能 够 帮 有 我 们 目 动 化 这 些 
BRIE: 
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.为 分 支 更 改 POM 的 有 版本， 例如 从 1.1.0-SNAPSHOT 改 变 成 1.1.1- 
SNAPSHOT 。 


.将 POM 中 的 SCM 信 息 更 新 为 分 文 地 址 。 


-提交 以 上 更 改 。 


将 主干 的 代码 复制 到 分 文中 。 


-修改 本 地 代码 使 其 回 退 到 分 之 前 的 版 本 (用 户 可 以 指定 新 的 版 
AX) 9 

.提交 本 地 更 改 。 

当然 ， 为 了 让 Maven Release Plugin 为 我 们 工作 ， 和 版 本 发 布 一 
样 ， 必 须 在 POM 中 提供 正确 的 SCM 人 信息。 此 外 ， 由 于 分 支 控 作 会 涉及 
版 本 控制 系统 里 的 分 文 地 址 ， 因 此 还 要 为 Maven Release Plugin 配 置 分 
文 基础 目 示 ， 如 代码 清单 13-4 所 示 。 


代码 清单 13-4 ”配置 maven-release-plugin 提 供 分 支 基 础 日 如 


然而 tagBase 和 branchBase 并 非 是 一 定 要 配置 的 。 如 果 为 版 本 控制 仓 
库 使 用 了 标准 的 Subversion 布 局 ， 即 在 平行 的 trunk/tags/branches 目 录 下 
分 别 放置 项 目 主干 代码 、 标 签 代码 和 分 文 代码， 那么 Maven Release 
Plugin 束 能 够 目 动 根据 主干 代码 位 置 计算 出 标签 及 分 文 代码 位 置 ， 因 此 
你 束 可 以 省 略 这 两 项 配置 。 


理解 了 创建 分 文 所 将 执行 的 实际 行为 后 ， 就 可 以 在 项 目 目 孙 下 运 
行 如 下 命令 以 创建 分 支 : 


Smvn release:branch -DbranchName =1.1.x \ 


-DupdateBranchVersions = true -DupdateWorkingCopyVersions = false 


Eime HEM T Maven Release Plugin 的 branch 目 标 ，- 
DbranchName=1.1.x 用 来 配置 所 要 创建 的 分 文 的 名 称 ，- 
DupdateBranchVersions=true 表 示 为 分 文 使 用 新 的 版 本 ，- 
DupdateWorkingCopyVersions=false 表 示 不 更 新 本 地 代码 (BEF) 的 
版 本 。 运 行 上 述 命令 之 后 ，Maven 会 提示 输入 分 支 项 目的 版 本 。 例 如 : 


What is the branch version for "app"? (com. juvenxu.mvnbook:app) 1.1.1-SNAPSHOT: : 


用 户 根据 目 己 的 需要 为 分 文 输入 新 的 版 本 后 按 Enter 键 ，Maven 隐 
会 处 理 其 余 的 操作 。 最 后 ， 用 户 束 能 在 源码 库 中 找到 Maven 创 建 的 分 
支 ， 如 https:/192.168.1.103/app/branches/1.1.x/。 在 这 里 ，POM 中 的 版 本 
已 经 升级 到 了 1.1.1-SNAPSHOT ° 


13.6 GPGS% 


当 从 中 央 仓 库 下 载 第 三 方 构件 的 时 候 ， 你 可 能 会 想 要 验证 这 些 文 
件 的 合法 性 ， 例 如 筷 们 是 由 开源 项 目 官方 发 布 的 ， 并 且 没有 被 自 改 
过 。 同 样 地 ， 当 发 布 目 己 项 目 给 客户 使 用 的 时 候 ， 你 的 客户 也 会 想 要 
难 证 这 些 文件 是 否 是 由 你 的 项 目 组 发 布 的 ， 且 没 有 被 恶意 修改 过 。 
PGP (Pretty Good Privacy) 就 是 这 样 一 个 用 来 帮助 提高 安全 性 的 技 
术 。PGP 最 常用 来 给 电子 邮件 进行 加 密 、 解 密 以 及 提供 签名 ， 以 提 融 
电子 邮件 交流 的 安全 性 。 本 市 介绍 如 何 使 用 PGP 技 术 为 发 布 的 Maven 
构件 签名 ， 为 项 目 增强 安全 性 。 


13.6.1 GPG 及 其 基本 使 用 


GnuPG (简称 GPG， 来 自 http://www.gnupg.org/) 是 PGP 标 准 的 一 
个 免费 实现 ， 无 论 是 类 UNIX 平 台 还 是 windows 平 台 ， 都 可 以 使 用 它 。 
GPG 能 够 帮助 我 们 为 文件 生成 签名 、 管 理 密 钥 以 及 验证 签名 等 。 


首先 ， 访 问 http:/www.gnupg.org/download/ 并 下 载 对 应 自己 平台 的 
GPG 分 发 包 ， 按 照 官方 的 文档 将 GPG 安 装 完毕 ， 运 行 如 下 命令 检查 安 


JE 


X: 
juven@ juven-ubuntu: ~- $ gpg --version 
gpg (GnuPG) 1.4.9Copyright (C) 2008 Free Software Foundation, Inc. 
License GPLv3 +: GNU GPL version 3 or later 


在 使 用 GPG 之 前 ， 先 得 为 目 己 准 备 一 个 密 钥 对 ， 即 一 个 私 钥 和 一 
个 公 钥 。 之 后 才 可 以 使 用 私 钥 对 文件 进行 签名 ， 并 且 将 公 钥 分 发 到 公 
钥 服 务 句 供 其 他 用 户 下 载 ， 用 户 可 以 使 用 公 钥 对 签名 进行 验证 。 


使 用 如 下 命令 生成 密 钥 对 : 


juven@ juven-ubuntu: ~ $ gpg --gen-key 


GPG 会 问 你 密 钥 的 类 型 、 大 小 和 有 效 时 间 ， 通 党 使 用 默认 的 值 即 
可 。GPG 还 会 要 求 你 输入 目 己 的 名 称 、 电 子 邮 件 地 址 和 对 密 钥 的 注 


释 ， 这 些 内 容 会 被 包 人 台 在 公 钥 中 并 被 你 的 用 户 看 到 ， 因 此 务必 正确 填 
写 。 最 后 ， 还 可 以 提供 一 个 密码 来 保护 密 钥 ， 这 不 是 强制 性 的 ， 但 通 
常 最 好 提供 以 防止 别人 得 到 你 的 密 钥 后 恶意 使 用 。 你 将 来 需要 使 用 私 
角 和 密码 为 文件 提供 签名 ， 因 此 一 定 要 认证 保护 它 们 。 


现在 已 经 有 了 密 钥 对 ， 就 可 以 在 命令 行 中 查看 它们 (其 他 导入 到 
本 地 机 器 的 密 钥 也 会 被 显示 ) ， 如 下 面 的 命令 可 用 来 列 出 所 有 公 钥 : 


juven@ juven-ubuntu: ~ $gpg --list-keys 

/home /juven/.gnupg /pubring. gpg 

pub 1024D/C6EED57A 2010-01 -13 

uid Juven Xu (Juven Xu works at Sonatype) juven@ sonatype. com 
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sub 2048¢/D704745C 2010 -01 -13 


这 里 的 home/juven/.gnupg/pubring.gpg 表 示 公 钥 存 储 的 位 置 。 以 pub 
开头 的 一 行 显示 公 钥 的 长 度 (1024D) 、ID (C6EEDS7A) 以 及 创建 日 
期 (2010-01-13) 。 下 一 行 显示 了 公 钥 的 UID， 也 就 是 一 个 由 名 称 、 

释 和 邮件 地 址 组 成 的 字符 串 。 最 后 一 行 显示 的 子 钥 不 用 关心 。 


类 似 地 ， 下 面 的 命令 用 来 列 出 本 机 私 钥 : 


uven@ juve buntu $ gpg -ist —secret-keys 

/home /juven/.cgnupg/secring. gpg 

ac 1024 6EEDS7A 2 0 -01 -13 

uid Juven Xu (Juven rks at Sonatype) 
ssb 2048 D704745C 2010 -01 -13 


对 GPG 的 公私 钥 有 了 基本 的 了 解 之 后 ， 就 可 以 使 用 如 下 命令 为 任 
意 文 件 创建 一 个 ASCII 格 式 的 签名 : 


juven@ juven-ubuntu: ~ $gpg -ab temp. java 


这 里 的 -a 选项 告诉 GPG 创 建 ASCII 格 式 的 输出 ， 而 -b 选 项 则 告诉 
GPG 创 建 一 个 独立 的 签名 文件 。 如 果 你 的 私 钥 拥 有 密码 ， 这 个 时 候 就 
需要 输入 密码 。 如 果 私 钥 没有 密码 ， 那 么 只 要 他 人 获得 了 你 的 私 钥 ， 
就 能 够 以 你 的 名 义 对 任何 内 容 进 行 签名 ， 这 是 非常 危险 的 。 


在 该 例 中 ，GPG 会 创建 一 个 名 为 temp.java.asc 的 签名 文件 ， 这 时 就 
可 以 将 这 个 后 缀 名 为 .asc 的 签名 文件 连同 原始 文件 一 起 分 发 给 你 的 用 
尸 。 如 果 你 的 用 户 已 经 导入 了 你 的 公 角 ,就 可 以 运行 如 下 命令 验证 原 
ROCF: 


$gpg —-verify temp. java.asc 


为 了 能 让 你 的 用 户 获 取 公 钥 并 验证 你 分 发 的 文件 ， 需 要 将 公 铀 分 
发 到 公 钥 服务 器 中 。 例 如 ，hkp: /pgp.mit,edu 是 美国 麻 省 理工 学 院 提 供 
的 公 钥 服务 磊 ， 运 行 如 下 命令 可 将 公 钥 分 发 到 该 服务 瑚 中 : 


$ gpg --keyserver hkp: //pgp.mit.edu --send-keys C6EED57A 


X BAY--keyserverize il ARTE ETRA ase HWHE, --send-keys H 
来 指定 想 要 分 发 公 钥 的 ID。 你 可 以 罗列 本 地 公 钥 来 查看 它们 的 ID。 需 


要 注意 的 是 ， 公 钥 会 在 各 个 公 钥 服务 器 中 被 同步 ， 因 此 你 不 需要 重复 
地 往 各 个 服务 邵 分 发 同一 公 钥 。 


现在 ， 你 的 用 户 可 以 将 服务 器 上 的 公 钥 导入 到 本 地 机 器: 


$ gpg --keyserver hkp: //pgp.mit.edu --recv-keys C6EED57A 


上 壕 束 是 一 个 基本 的 签名 、 分 发 并 验证 的 流程 ， 在 使 用 Maven 发 布 
项 目的 时 候 ， 可 以 使 用 GPG 为 发 布 文件 提供 签名 。 现 在 读者 应 该 已 经 
知道 如 何 手工 完成 这 一 步骤 了 ， 下 面 介 绍 如 何 使 用 Maven GPG Plugin 
目 动 化 签名 这 一 步骤 。 


13.6.2 Maven GPG Plugin 


手动 地 对 Maven 构 件 进行 签名 并 将 这 些 签名 部 署 到 Maven 仓 库 中 是 
一 件 耗 时 的 体力 活 。 而 使 用 Maven GPG Plugin 只 需要 提供 几 行 简单 的 
配置 ， 它 就 能 够 帮 有 我 们 目 动 完成 签名 这 一 工作 。 


在 使 用 Maven GPG Plugin 之 前 ， 首 先 需 要 确认 命令 行 下 的 gpg 古 可 
用 的 ， 然 后 如 代码 清单 13-5 所 示 配 置 POM 。 


代码 清单 13-5 配置 maven-gpg-plugin 为 项 目 提供 签名 


<project > 


<build> 
<plugins > 
<plugin > 
<groupid >org. apache. maven. plugins < /groupId > 
<artifactId >maven-gpg-plugin < /artifactId > 
>1.0</version> 


然后 就 可 以 使 用 一 般 的 mvn 命 令 签名 并 发 布 项 目 构件 : 


$mvn clean deploy -Dgpg. passphrase = yourpassphrase 


如 果 不 提 供 -Dgpg.passphrase 参 数 ， 运 行 时 就 会 要 求 输入 密码 。 


如 条 有 一 些 已 经 发 布 了 但 没有 被 签名 的 文件 ， 你 仍然 想 对 其 签名 


并 发 布 到 Maven 仓 库 中 ， 上 壕 方式 显然 是 行 不 通 的 ， 因 为 POM 已 经 不 
允许 被 修改 。 好 在 Maven GPG Plugin 为 此 提供 了 另外 一 个 目标 。 例 


如 : 


Smvn gpg:sign-and-deploy-file 


: 
ID, 


要 


—DpomFile =target /myapp —1.0.pom 

—Dfile =target /myapp -1.0.jar 

—Durl =http: //oss. sonatype. org /service /local /staging /deploy /maven2 / 
—DrepositoryId = sonatype_oss 


在 这 里 可 以 指定 要 签名 的 POM 及 相关 文件 、Maven 仓 库 的 地 址 和 
Maven GPG Plugin 束 会 帮 你 签名 文件 并 部 署 到 仓库 中 。 


读者 可 以 想到 ，GPG 签 名 这 一 步骤 只 有 在 项 目 发 布 时 才 显 得 必 
对 日 常 的 SINAPSHOT 构 件 进 行 签名 不 仅 没 有 多 大 的 意义 ， 反 而 会 


比较 耗 时 。 因 此 ， 只 需要 配置 Maven PGP Plugin 在 项 目 发 布 的 时 候 运 


T 


那么 如 何 判断 项 目 发 布 呢 ?回顾 代码 清单 13-3， 在 超级 POM 中 有 


一 个 release-profile， 该 Profile 只 有 在 Maven 属 性 performRelease 为 true 的 
时 候 才 被 激活 ， 而 release: perform 执 行 的 时 候 ， 就 会 将 该 属性 置 为 
true， 这 正 古 项 目 进 行 版 本 发 布 的 时 刻 。 因 此 ， 类 似 地 ， 可 以 在 
settings.xml 或 者 POM 中 创建 如 代码 清单 13-6 所 示 Profile ° 


©) 


代码 清单 13-6 ”配置 自动 激活 的 Profile 对 项 目 进行 签名 


<profiles> 
<profile> 
<id>release-sign-artifacts < /id> 
<activation> 
<property > 
<name >performRelease < /name > 
<value >true < /value > 


<build> 
<plugins > 
<plugin> 
< groupId >org. apache. maven. plugins < /groupld > 
<artifactId >maven-gpg-plugin < /artifactId > 
<version >1.0</version > 
<executions > 
<execution > 
<id>sign-artifacts </id> 
<phase >verify < /phase > 


<goal >sign< /goal > 


< /exec uti on > 
z fexecutions > 
</ jp] ugin > 
< /plugins > 
< /build> 
< /profile > 


</profiles > 


最 后 需要 一 提 的 是 ， 由 于 一 个 已 知 的 Maven Release Plugin 的 Bug， 
release: perform 执 行 过 程 中 签名 可 能 会 导致 进程 永久 挂 起 。 为 了 避免 
该 情况 ， 用 户 需 要 为 Maven Release Plugin 提 供 mavenExecutorId 配 置 ， 
如 代码 清单 13-7 所 示 。 


代码 清单 13-7 ”配置 maven-release-plugin 避 免 签 名 时 永久 挂 起 


<plugin> 
<grouplid >org. apache. maven. plu agins < /grouplid> 
mek aN maven-release pl n</artifactId> 
<version >2.0</version: 
< configuration > 


<tagBase >https://192.168.1. 103 /app/tags/ < /tagBase > 
< branchBase >ht tps: //15 92..168.1.103 /app/branches / < /branchBase > 
cmavenExecutorid > forked- putin /mavenExecutorid > 


< /configuration > 
< /plugin > 


至 此 ， 一 个 较为 规范 的 自动 化 签名 配置 就 完成 了 。 当 执行 release: 
perform 发 布 项 目 版 本 的 时 候 ，maven-gpg-plugin 会 被 自动 调用 对 构件 进 
行 答 名。 当然 ， 这 个 时 候 你 需要 根据 命令 行 提示 输入 私 钥 密码 。 


13.7 AY 


项 目 开发 到 一 定 阶段 后 ， 束 必然 要 面 对 版 本 发 布 的 问题 ， 本 章 介 
绍 了 Maven 的 版 本 管理 方式 ， 包 括 快 照 版 和 发 布 版 之 间 的 转换 、 各 种 
版 本 号 的 意义 以 及 项 目 版 本 与 版 本 控制 系统 (如 Subversion) 之 间 的 关 
系 。 理 解 了 版 本 转换 与 SCM 操 作 的 天 系 后 ， 就 可 以 使 用 Maven Release 
Plugin 目 动 化 版 本 发 布 和 创建 分 文 等 操作 。 本 章 最 后 介绍 了 如 何在 版 
本 发 布 的 时 候 使 用 GPG 为 构件 提供 签名 ， 以 提供 更 强 的 安全 性 。 


第 14 章 ”灵活 的 构建 
本 章 内 容 
.Maven 属 性 


:构建 环境 的 差异 
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一 个 优秀 的 构建 系统 必须 足够 灵活 ， 它 应 该 能 够 让 项 目 在 不 同 的 
环境 下 都 能 成 功 地 构建 。 例 如 ， 典 型 的 项 目 都 会 有 开发 环境 、 测 试 环 
境 和 产品 环境 ， 这 些 环境 的 数据 库 配 置 不 尽 相 同 ， 那 么 项 目 构建 的 时 
候 束 需要 能 够 识别 所 在 的 环境 并 使 用 正确 的 配置 。 还 有 一 种 常见 的 情 
况 是 ， 项 目 开 发 了 大 量 的 集成 测试 ， 这 些 测 试 运行 起 来 非常 耗 时 ， 不 
适合 在 每 次 构建 项 目的 时 候 都 运行 ， 因 此 需要 一 种 手段 能 让 我 们 在 特 
定 的 时 候 才 激活 这 些 集 成 测试 。Maven 为 了 支持 构建 的 灵活 性 ， 内 置 


了 三 大 特性 ， 即 属性 、Profile 和 资源 过 滤 。 本 章 介绍 如 何 合理 使 用 这 
些 特性 来 帮助 项 目 目 如 地 应 对 各 种 环境 。 


14.1 Maven 属 性 


前 面 的 章节 已 经 简单 介绍 过 Maven 属 性 的 使 用 ， 例 如 在 5.9.2 节 有 如 
代码 清单 14-1 所 示 的 代码 。 


代码 清单 14-1 ”使 用 Maven 属 性 归 类 依赖 


<properties > 
<springframework. version >2.5.6 < /springframework. version > 


< /properties > 


< dependencies > 


< dependency > 
< ee >org.springframework < /gro pis Id 
cartifactId >spring-core </artifactId > 
<version> $ {springframework. versi< =e < ersion > 
depender ioy > 

<depe endency > 
oupl tds >org. ringframework < /groupi 

sant ifactId >spring-beans < /artifa set Id » 


<version> $ pime ringframework. version} < /version > 


< /dependency > 


< /dependencies > 


这 可 能 是 最 常见 的 使 用 Maven 属 性 的 方式 ， 通 过 <properties> 元 于 
用 户 可 以 目 定义 一 个 或 多 个 Maven 必 性， 然后 在 POM 的 其 他 地 方 使 用 
$ {属性 名 称 } 的 方式 引用 该 属性 ， 这 种 做 法 的 最 大 意义 在 于 消除 重 
复 。 例 如 ， 代 码 清单 14-1 中 本 来 需要 在 多 个 地 方 重复 声明 同样 的 
SpringFramework 版 本 ， 现 在 只 在 一 个 地 方 声 明 就 可 以 ， 重复 越 多 ， 好 
处 束 越 明显 。 因 为 这 样 不 仅 减 少 了 日 后 升级 版 本 的 工作 量 ， 也 能 降低 
错误 发 生 的 概率 。 


这 不 是 Maven 属 性 的 全 部 ， 事 实 上 这 只 是 6 类 Maven 必 性 中 的 一 类 
而 已 。 这 6 类 属性 分 别 为 : 


内置 属性 : 主要 有 两 个 钊 用 内 置 属性 一 一 下 {basedir} 表 示 项 目 根 
目录 ， 即 包 仿 pom.xml 文 件 的 目录 ;$B {version} 表 示 项 目 版 本 。 


POMS IE: 用户 可 以 使 用 该 类 属性 引用 POM 文 件 中 对 应 元 素 的 
值 。 例 如 {project.artifactId} 束 对 应 了 <project><artifactId> 元 素 的 值 ， 
常用 的 POM 属 性 包括 : 


m $ {project.build.sourceDirectory}: 项 目的 主 源码 目录 ， 默 认为 


src/main/java/ ° 


m $ {project.build.testSourceDirectory}: 项 目的 测试 源码 目 孙 ， 默 
认为 src/test/java/。 


m $ {project.build.directory}: 项 目 构 建 输出 目录 ， 默 认为 target/。 


mS {project.outputDirectory}: 项 目 主 代码 编译 输出 目录 ， 默 认为 


target/classes/ ° 


m $ {project.testOutputDirectory}: 项 目测 试 代 码 编译 输出 目 永 ， 默 


认为 target/test-classes/。 


mS {project.groupId}: 项 目的 groupId ° 


mS {project.artifactlId}: 项 目的 artifactId ° 


$ {project.version}: 项 目的 version， 与 $$ {version} ŒM ° 


m $ {project.build.finalName}: 项 目 打包 输出 文件 的 名 称 ， 默 认为 


$ {project.artifactId}- $ {project.version} ° 


这 些 属 性 都 对 应 了 一 个 POM 元 素 ， 它 们 中 一 些 属性 的 默认 值 都 是 
在 超级 POM 中 定义 的 ， 可 以 参考 8.5 节 。 


BEBE: 用 户 可 以 在 POM 的 <properties> 元 素 下 目 定 义 Maven 
属性 。 例 如 : 


然后 在 POM 中 其 他 地 方 使 用 {my.prop} 的 时 候 会 被 巷 换 成 hello。 


“Settings 属 性 ， 与 POM 属 性 同 理 ， 用 户 使 用 以 settings. 开 头 的 属性 
引用 settings.xml 文 件 中 XML 元 素 的 值 ， 如 常用 的 旬 
{settings.localRepository} 指 向 用 户 本 地 仓库 的 地 址 。 


-Java 系统 属性 : 所 有 Java 系 统 属性 都 可 以 使 用 Maven 属 性 引用 ， 例 
QS fuserhome} 指 回 了 用 户 目 永 。 用 户 可 以 使 用 mvn help: system 查 看 


所 有 的 Java 系 统 属 性 


.环境 变量 属性 : 所 有 环境 变量 都 可 以 使 用 以 env. 开 头 的 Maven 属 性 
引用 。 例 如 $$ {fenvJAVA_HOME} 指 代 了 JAVA_HOME 环 境 变 量 的 值 。 
用 户 可 以 使 用 mvn help: system 查 看 所 有 的 环境 变量 。 


正确 使 用 这 些 Maven 属 性 可 以 帮助 我 们 简化 POM 的 配置 和 维护 工 
作 ， 下 面 列举 几 个 和 常见 的 Maven 属 性 使 用 样 例 。 


在 一 个 多 模块 项 目 中 ， 模 块 之 间 的 依赖 比较 和 常见， 这些 模 块 通常 
会 使 用 同样 的 groupId 和 version。 因 此 这 个 时 候 束 可 以 使 用 POM 属 性 ， 
如 代码 清单 14-2 所 示 。 


代码 清单 14-2 ”使 用 POM 属 性 配置 依赖 


在 代码 清单 14-2 中 ， 当 前 的 模块 依赖 于 account-email 和 account- 
persist， 这 三 个 模块 使 用 同样 的 groupId 和 version， 因 此 可 以 在 依赖 配置 
中 使 用 POM 属 性 S {project.groupld} Fl $ {project.version}， 表 示 这 两 个 


依赖 的 groupId 和 version 与 当前 模块 一 致 。 这 样 ， 当 项 目 版 本 升级 的 时 
候 ， 就 不 再 需要 更 改 依 赖 的 版 本 了 。 


大 量 的 Maven 搬 件 用 到 了 Maven 属 性 ， 这 意味 着 在 配置 插件 的 时 候 
同样 可 以 使 用 Maven 属 性 来 方便 地 目 定 义 插件 行为 。 例 如 从 10.6 太 我 们 
知道 ，maven-surefire-plugin 运 行 后 默认 的 测试 报告 目录 为 target/surefire- 


reports， 这 实际 上 就 是 $ {project.build.directory}/surefire-reports， 如 果 
查阅 该 插件 的 文档 ， 会 发 现 该 插件 提供 了 reportsDirectory 参 数 来 配置 测 
斌 报告 目录 。 因 此 如 果 想 要 改变 测试 报告 目录 ， 例 如 改 成 target/test- 
reports， 就 可 以 像 代 码 清单 14-3 这 样 配 置 。 


代码 清单 14-3 ”使 用 Maven 属 性 配置 插件 


从 上 面 的 内 容 中 可 以 看 到 ，Maven 属 性 能 让 我 们 在 POM 中 方便 地 
引用 项 目 环 境 和 构建 环境 的 各 种 十 分 有 用 的 值 ， 这 是 创建 灵活 构建 的 
基础 。 下 面 将 会 结合 profile 和 资源 过 滤 ， 展 示 Maven 能 够 为 构建 提供 的 
更 多 的 可 能 性 。 


14.2 ”构建 环境 的 老 异 


在 不 同 的 环境 中 ， 项 目的 源码 应 该 使 用 不 同 的 方式 进行 构建 ， 最 
常见 的 就 是 数据 库 配 置 了 。 例 如 在 开发 的 过 程 中 ， 有 些 项 目 会 在 
src/main/resources/ 目 录 下 放置 各 有 如 下 内 容 的 数据 库 配 置 文件 : 


database. jdbc.driverClass =com.mysql. jdbc. Driver 
database. jdbc. connectionURL = jdbc :mysql://localhost :3306 /test 
database. jdbc. username = dev 


database. jdbc. password = dev-pwd 


这 本 没什么 问题 ， 可 当 测 试 人 员 想 要 构建 项 目 产 品 并 进行 测试 的 
时 候 ， 他 们 往往 需要 使 用 不 同 的 数据 库 。 这 时 的 数据 库 配 置 文件 可 能 
是 这 样 的 : 
database. jdbc. driverClass =com. mysql. jdbc. Driver 
database. jdbc. connectionURL = jdbc :mysql://192.168.1.100 :3306 /test 


database. jdbc, username =test 


database. jdbc. password = test-—pwd 


连接 数据 库 的 URL、 用 户 名 和 密码 都 发 生 了 变化 ， 类 似 地 ， 当 项 
目 被 发布 到 产品 环境 的 时 候 ， 所 使 用 的 数据 库 配 置 义 是 为 外 一 套 了 。 
这 个 时 候 ， 比 较 原始 的 做 法 是 ， 使 用 与 开发 环境 一 样 的 构建 ， 然 后 在 
测试 或 者 发 布 产品 之 前 再 手动 更 改 这 些 配置 。 这 是 可 行 的 ， 也 是 比较 
常见 的 ,但 肯定 不 古 最 好 的 方法 。 本 书 已 经 不 止 一 次 强调 ， 手 动 往往 
号 意味 着 低 效 和 错误 ， 因 此 需要 找到 一 种 方法 ， 使 它 能 够 自动 地 应 对 
构建 环境 的 差异 。 


Maven 的 答案 是 针对 不 同 的 环境 生成 不 同 的 构件 。 也 就 是 说 ， 在 构 
建 项 目的 过 程 中 ，Maven 就 已 经 将 这 种 差异 处 理 好 了 。 


为 了 应 对 环境 的 变化 ， 首 先 需 要 使 用 Maven 属 性 将 这 些 将 会 发 生变 
化 的 部 分 提取 出 来 。 在 上 一 节 的 数据 库 配 置 中 ， 连 接 数 据 库 使 用 的 驱 
DIR ` URL ` 用户 名 和 密码 都 可 能 发 生变 化 ， 因 此 用 Maven 属 性 取代 它 
们 : 


database.Jdbc.driverClass = § {db. driver } 
database. jdbe. connect 1onURL S iii url} 
database. jdbc. username = $ {Gb. username} 
database. jdbc. password = $ (db. password} 


这 里 定义 了 4 个 Maven 属 性 : db.driver ` db.url ` db.username#i 
db.password， 它 们 的 命名 是 任意 的 ， 读 者 可 以 根据 自己 的 实际 情况 定 
义 最 合适 的 属性 名 称 


既然 使 用 了 Maven 属 性 ， 束 应 该 在 某 个 地 方 定 义 它 们 。14.1 市 介 
过 如 何 目 定 义 Maven 属 性 ， 这 里 要 做 的 是 使 用 一 个 额外 的 profile 将 其 包 
误 ， 如 代码 清单 14-4 所 示 。 


代码 清单 14-4 针对 开发 环境 的 数据 库 配置 


<profiles > 
<profile> 
<id>dev</id> 
<properties > 
<db. driver >com.mysql. jdbc. Driver < /db. driver > 
<db.url > ji dive mmysql://192.168.1.100:3306/test < /db. url > 
<db. username > dev < /db. username > 


代码 清单 14-4 中 的 Maven 属 性 定义 与 直接 在 POM 的 properties 元 素 下 
定义 并 无 二 致 ， 这 里 只 是 使 用 了 一 个 id 为 dev 的 profile， 其 目的 是 将 开 
发 环境 下 的 配置 与 其 他 环境 区 别 开 来 。 关 于 profile， 本 章 将 详细 解释 。 


有 了 属性 定义 ， 配 置 文件 中 也 使 用 了 这 些 属性 ,一切 OK 了 吗 ? 还 
不 行 。 读 者 要 留意 的 是 ，Maven 属 性 黑 认 只 有 在 POM 中 才 会 被 解析 。 
也 就 是 说 ，$ {db.username} 放 到 POM 中 会 变 成 test， 但 是 如 果 放 到 
src/main/resources/ 目 录 下 的 文件 中 ， 构 建 的 时 候 它 将 仍然 还 十 多 
{db.username}。 因 此 ， 需 要 让 Maven 解 析 资 源 文 件 中 的 Maven 属 性 。 


资源 文件 的 处 理 其 实 是 maven-resources-plugin 做 的 事情 ， 它 默认 的 
行为 只 是 将 项 目 主 资源 文件 复制 到 主 代码 编译 输出 目录 中 ， 将 测试 资 
源 文 件 复制 到 测试 代码 编译 输出 日 隶 中。 不 过 只 要 通过 一 些 位 单 的 
POM 配 置 ， 该 插件 就 能 够 解析 资源 文件 中 的 Maven 属 性 ， 即 开局 资源 
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Maven 默 认 的 主 资源 目 永 和 测试 资源 目录 的 定义 是 在 超级 POM 中 
(可 以 回顾 8.5 节 ) 。 要 为 资源 目录 开启 过 滤 ， 只 要 在 此 基础 上 添加 一 
行 filtering 配 置 即 可 ， 如 代码 清单 14-5 所 示 。 


代码 清单 14-5 ”为 主 资 源 目录 开局 过 滤 


<resources > 
<resource > 
<directory > $ {project.basedir}/src/main/resources < /directory > 
<filtering >true < /filtering > 
< /resource > 
<resources > 


类 似 地 ， 代 码 清单 14-6 中 的 配置 为 测试 资源 目录 开局 了 过 滤 


[0] 


代码 清单 14-6 KMR BRAT ae 


<testResources > 
<testResource > 
<directory > $ {project.basedir}/src/ test /resources < /directory > 
< filtering >true < /filtering > 
< /testResource > 
< /testResources > 


读者 可 能 还 会 从 上 述 代 码 中 意识 到 ， 主 资源 目录 和 测试 资源 目录 
都 可 以 超过 一 个 ， 虽 然 会 破坏 Maven 的 约定 ， 但 Maven 人 允许 用 户 声明 多 
个 资源 目录 ， 并 且 为 每 个 资源 目录 提供 不 同 的 过 滤 配 置 ， 如 代码 清单 
14-7 所 示 。 


代码 清单 14-7 ”配置 多 个 资源 目录 


<resources > 
< resource > 


<directory >src/main/resources < /directory > 
< filtering >true < /filtering > 
< /resource > 


< directory >src/main/sql < /directory > 


>false< /filtering > 


代码 清单 14-7 配 置 了 两 个 资源 上 日 隶 ， 其 中 src/main/resources 开 启 了 
过 滤 ， 而 srwmain/sql] 没 有 启用 过 滤 。 


到 目前 为 止 一 切 基本 就 绪 了 ， 我 们 将 数据 库 配 置 的 变化 部 分 提取 
成 了 Maven 属 性 ， 在 POM 的 profile 中 定义 了 这 些 属性 的 值 ， 并 且 为 资源 
目录 开启 了 属性 过 小 。 最 后 ， 只 需要 在 命令 行 激 活 profile，Maven 就 能 


够 在 构建 项 目的 时 候 使 用 profile 中 属性 值 奉 换 数 据 库 配 置 文件 中 的 属性 
引用 。 运 行 命令 如 下 : 


$mvn clean install-Pdev 


mvn 的 -P 参 数 表 示 在 命令 行 激活 一 个 profile。 这 里 激活 了 id 为 dev 的 


profile。 构 建 完成 后 ， 输 出 目录 中 的 数据 库 配 置 就 是 开发 环境 的 配置 
T: 


databas es c.driverClass =com. mysql. jdbc. Driver 

databas as onnectionURL = jdbc :mysql://locall t:3306 /test 
database. jdbc. username = dev 

dat shag se. jdbc. password = dev-pwd 


14.4 Maven Profile 


从 前 面 内 容 我 们 看 到 ， 不 同 环境 的 构建 很 可 能 是 不 同 的 ， 典 型 的 
情况 殊 古 数据 库 的 配置 。 除 此 之 外 ， 有 些 环境 可 能 需要 配置 插件 使 用 
本 地 文件 ， 或 者 使 用 特殊 版 本 的 依赖 ， 或 者 需要 一 个 特殊 的 构件 名 
称 。 要 想 使 得 一 个 构建 不 做 任何 修改 束 能 在 任何 环境 下 运行 ， 往 往 是 
不 可 能 的 。 为 了 能 让 构建 在 各 个 环境 下 方便 地 移植 ，Maven 引 入 了 
profile 的 概念 。profile 能 够 在 构建 的 时 候 修改 POM 的 一 个 于 集 ， 或 者 添 
加 额外 的 配置 元 素 。 用 户 可 以 使 用 很 多 方式 激活 profile， 以 实现 构建 
在 不 同 环境 下 的 移植 。 


14.4.1 ”针对 不 同 环境 的 profile 


继续 以 14.2 世 介绍 的 数据 库 差 异 为 例 ， 代 码 清单 14-43| 入 了 一 个 针 
对 开发 环境 的 profile， 类 似 地 ， 可 以 加 入 测试 环境 和 产品 环境 的 
profile， 如 代码 清单 14-8 所 示 。 


代码 清单 14-8 基于 开发 环境 和 测试 环境 的 profile 


<profiles > 
<profile> 
<id>dev</id> 


<db. driver >com. mysql. jdbc. Driver < /db. driver 
:mysql :// localhost :3306 /test < /db -url> 


r< /db. username > 


ord > dev-pwd < /db. password > 


<propertie 
<db. driver >com. mysql. jdbc. Driv E er> 
c- db. url >jdbc:mysql://192. 168 00 :3306/t EFA... WEL & 
<db. username >test < /db. username > 

<db. password >test-pwd < /db. password > 


< /properties > 
</profile> 
< /profiles > 


同样 的 属性 在 两 个 profile 中 的 值 古 不 一 样 的 ，dev profilet T7 
发 环境 数据 库 的 配置 ， 而 test profile 提 供 的 是 测试 环境 数据 库 的 配置 。 
类 似 地 ， 还 可 以 添加 一 个 基于 产品 环境 数据 库 配置 的 profile。 由 于 篇 幅 
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现在 ， 开 发 人 员 可 以 在 使 用 mvn 命 令 的 时 候 在 后 面 加 上 -Pdev 激 活 
dev profile， 而 测试 人 员 可 以 使 用 -Ptest 激 活 test profile ° 


14.4.2 ”激活 profile 
为 了 尽 可 能 方便 用 户 ，Maven 文 持 很 多 种 激活 Profile 的 方式 。 
用 户 可 以 使 用 mvn 命 令 行 参 数 -P 加 上 profile 的 id 来 激活 profile， 多 个 


id 之 间 以 去 号 分 隔 。 例 如 ， 下 面 的 命令 激活 了 dev-x 和 dev-y 两 个 
profile: 


$ mvn clean install 一 Pdev -x,dev-y 


2.settings 文 件 显 式 激活 


如 果 用 户 硕 望 某 个 profile 默 认 一 直 处 于 激活 状态 ， 就 可 以 配置 
settings.xml 文 件 的 activeProfiles 元 素 ， 表 示 其 配置 的 profile 对 于 所 有 项 
目 都 处 于 激活 状态 ， 如 代码 清单 14-9 所 示 。 


代码 清单 14-9 ”settings 文 件 显 式 激活 profile 


9.5 太 就 曾 经 用 到 这 种 方式 默认 激活 了 一 个 天 于 仓库 配置 的 


profile ° 
3. 系 统 属性 激活 


用 户 可 以 配置 当 某 系统 属性 存在 的 时 候 ， 上 自动 激活 profile， 如 代码 
清单 14-10 所 示 ° 


代码 清单 14-10 某 系统 属性 存在 时 激活 profile 


可 以 进一步 配置 当 某 系统 属性 test 存 在 ， 且 值 等 于 x 的 时 候 激活 
profile， 如 代码 清单 14-11 所 示 。 


代码 清单 14-11 某 系 统 属性 存在 且 值 确定 时 激活 profile 
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$mvn clean install -Dtest =x 


因此 ， 这 其 实 也 是 一 种 从 命令 行 激活 profile 的 方法 ， 而 且 多 个 
profile 完 全 可 以 使 用 同一 个 系统 属性 来 激活 。 


4. 操 作 系统 环境 激活 


Profile 还 可 以 自动 根据 操作 系统 环境 激活 ， 如 采 构 建 在 不 同 的 操作 
系统 有 差异 ， 用 户 完全 可 以 将 这 些 甜 异 写 进 profile， 然 后 配置 它们 目 动 
基于 操作 系统 环境 激活 ， 如 代码 清单 14-12 所 示 。 


代码 清单 14-12 ”基于 操作 系统 环境 激活 profile 


<profiles > 


<profile> 


<activation > 
<05 > 
<name >Windows XP < /name > 
< family >Windows < / family > 
<arch >x86 < /arch > 
< version >5.1.2600 < /version > 
< 4 os > 
< f/activation > 
< /profile> 
< /profiles > 


这 里 family 的 值 包括 Windows、UNIX 和 Mac 等 ， 而 其 他 儿 项 name、 
arch、version， 用 户 可 以 通过 查看 环境 中 的 系统 属性 os.name、os.arch、 


os.version 获 得 。 
5. 文 件 存在 与 否 激活 


Maven 能 够 根据 项 目 中 某 个 文件 存在 与 否 来 决定 是 否 激 活 profile， 
如 代码 清单 14-13 所 示 。 


代码 清单 14-13 ”基于 文件 存在 与 否 激活 profile 


<profiles > 
<profile> 
<activation > 
<file> 
<missing >x.properties < /missing > 
<exists >y. properties < /exists > 
</file> 
< /activation > 


</profile> 


< /profiles > 


6. 默 认 激活 


用 户 可 以 在 定义 profile 的 时 候 指定 其 默认 激活 ， 如 代码 清单 14-14 
所 示 。 


代码 清单 14-14 ”默认 激活 profile 


使 用 activeByDefault 元 素 用 户 可 以 指定 profile 自 动 激 活 。 不 过 需要 
注意 的 是 ， 如 果 POM 中 有 任何 一 个 profile 通 过 以 上 其 他 任意 一 种 方式 被 
激活 了 ， 所 有 的 默认 激活 配置 都 会 失效 。 


如 果 项 目 中 有 很 多 的 profile， 它 们 的 激活 方式 各 异 ， 用 户 怎么 知道 
哪些 profile 被 激活 了 呢 ? maven-help-plugin 提 供 了 一 个 目标 帮助 用 户 了 
解 当 前 激活 的 profile: 


$mvn help:active-profiles 


maven-help-plugini 还 有 另外 一 个 目标 用 来 列 出 当前 所 有 的 profile: 


$mvn help:all-profiles 


14.4.3 ”profile 的 种 类 


根据 具体 的 需要 ， 可 以 在 以 下 位 置 声明 profile: 
‘pom.xml: 很 显然 ，pom.xml 中 声明 的 profile 只 对 当前 项 目 有 效 。 


.用 户 settings.xml: 用 户 目 录 下 .m2/settings.xml 中 的 profile 对 本 机 上 
该 用 户 所 有 的 Maven 项 目 有 效 。 


.全 局 settings.xml: Maven 安 装 目 录 下 conf/settings.xml 中 的 profile 对 
本 机 上 所 有 的 Maven 项 目 有 效 。 


-profiles.xml (Maven 2) : 还 可 以 在 项 目 根 目录 下 使 用 一 个 额外 的 
profiles.xml 文 件 来 声明 profile， 不 过 该 特性 已 经 在 Maven 3 中 被 移 除 。 
建议 用 户 将 这 类 profile 移 到 settings.xml 中 。 


2.7.2 节 已 经 解释 过 ， 为 了 不 影响 其 他 用 户 且 方便 升级 Maven， 用 户 
应 该 选择 配置 用 户 范围 的 settings.xml， 避 免 修 改 全 局 范围 的 settings.xml 
文件 。 也 正 是 因为 这 个 原因 ， 一 般 不 会 在 全 局 的 settings.xml 文 件 中 添加 
profile 。 


像 profiles.xml 这 样 的 文件 ， 黑 认 是 不 会 被 Maven 安 装 到 本 地 仓库 ， 
或 者 部 署 到 远程 仓库 的 。 因 此 一 般 来 说 应 该 避免 使 用 ，Maven 3 也 不 再 
文 持 该 特性 。 但 如 果 在 用 Maven 2， 而 且 需要 为 几 十 或 者 上 百 个 客户 执 


行 不 同 的 构建 ， 往 POM 中 放置 这 么 多 的 profile 可 能 就 不 太 好 。 这 时 可 以 
选择 使 用 profiles.xml， 如 代码 清单 14-15 所 示 。 


代码 清单 14-15 ”使 用 profiles.xml 


“profiles> 
<profile > 
<id>client -001</id> 
<properties > 
<css.pref >blue.css </css.pref > 
< /properties > 
< /profile > 
<profile > 


<id>client -002 </id> 


<properties > 
<css.pre red ef 
/properties > 
< /profile> 
<profile> 
<id>client 一 ( id 


如 果 是 Maven 3， 则 应 该 把 这 些 内 容 移动 到 settings.xml 中 。 


不 同类 型 的 profile 中 可 以 声明 的 POM 元 素 也 是 不 同 的 ，pom.xml 中 
的 profile 能 够 随 着 pom.xml 一 起 被 提 交 到 代码 仓库 中 、 被 Maven 安 装 到 
本 地 仓库 中 、 被 部 团 到 远程 Maven 仓 库 中 。 换 言 之 ， 可 以 保证 该 profile 
伴随 着 某 个 特定 的 pom.xml 一 起 存在 ， 因 此 它 可 以 修改 或 者 增加 很 多 
POM 元 素 ， 见 代码 清早 14-16。 


代码 清单 14-16 ”POM 中 的 profile 可 使 用 的 元 素 


<project > 

<repositories > < /repositories > 

<pluginRepositories > < /pluginRepositories > 
<distributionManagement > < /distributionManagement > 


< dependencies > 


> < /dependencyManagement > 


从 代码 清单 14-16 中 可 以 看 到 ， 可 供 pom 中 profile 使 用 的 元 陛 非 党 
多 ， 在 pom profile 中 用 户 可 以 修改 或 添加 仓库 、 插 件 仓库 以 及 部 署 仓库 
地 址 ， 可 以 修改 或 着 添加 项 目 依 赖 ， 可 以 修改 聚合 项 目的 聚合 配置 ; 
可 以 目 由 添加 或 修改 Maven 属 性 ; 添加 或 修改 项 目 报告 配置 ， pom 
profile 还 可 以 添加 或 修改 插件 配置 、 项 目 资源 目 台 和 测试 资源 目 隶 配 鞋 
以 及 项 目 构 件 的 默认 名 称 。 


与 pom.xml 中 的 profile 对 应 的 ， 是 其 他 三 种 外 部 的 profile， 由 于 无 
法 保证 它们 能 够 随 着 特定 的 pom.xml 一 起 被 分 发 ， 因 此 Maven 不 允许 它 
们 添加 或 者 修改 绝 大 部 分 的 pom 元 素 。 举 个 简单 的 例子 。 假 设 用 户 Jack 
在 自己 的 settings.xml 文 件 中 配置 了 一 个 profile， 为 了 让 项 目 A 构 建成 
功 ，Jack 在 这 个 profile 中 声明 几 个 依赖 和 几 个 插件 ， 然 后 通过 激活 该 
profile 将 项 目 构 建成 功 了 。 但 是 ， 当 其 他 人 获得 项 目 A 的 源码 后 ， 它 们 
并 没有 Jack settings.xml 中 的 profile， 因 此 它们 无 法 构建 项 目 ， 这 就 导致 


了 构建 的 移植 性 问题 。 为 了 避免 这 种 问题 的 出 现 ，Maven 不 允许 用 户 在 
settings.xml 的 profile 中 声明 依赖 或 者 插件 。 事 实 上 ， 在 pom.xml 外 部 的 
profile 只 能 够 声明 如 代码 清单 14-17 所 示 儿 个 元 素 。 


代码 清单 14-17 POM 外 部 的 profile 可 使 用 的 元 素 


现在 不 用 担心 POM 外 部 的 profile 会 对 项 目 产 生 太 大 的 影响 了 ， 事 实 
上 这 样 的 profile 仅 仅 能 用 来 影响 到 项 目的 仓库 和 Maven 属 性 。 


14.5 “Web 资源 过 滤 


14.3 节 介绍 了 如 何 开启 资源 过 滤 ， 在 web 项 目 中 ， 资 源 文件 同样 位 
于 src/main/resources/ 目 录 下 ， 它 们 经 处 理 后 会 位 于 WAR 包 的 WEB- 
INF/classes 目 录 下 ， 这 也 是 Java 代 码 编译 打包 后 的 目录 。 也 就 是 说 ， 这 
类 资源 文件 在 打包 过 后 位 于 应 用 程序 的 classpath 中 。Web 项 目 中 还 有 另 
外 一 类 资源 文件 ， 默 认 它 们 的 源码 位 于 src/main/webapp/ 目 录 ， 经 打包 
后 位 于 WAR 包 的 根 目 录 。 例 如 ， 一 个 Web 项 目的 css 源 码 文件 在 
src/main/webapp/css/ 目 录 ， 项 目 打 包 后 可 以 在 WAR 包 的 css/ 目 录 下 找到 
对 应 的 css 文 件 。 这 一 类 资源 文件 称 做 web 资 源 文 件 ， 它 们 在 打包 过 后 
不 位 于 应 用 程序 的 classpath 中 。 


与 一 般 的 资源 文件 一 样 ，web 资 源 文件 默认 不 会 被 过 滤 。 开 启 一 般 
资源 文件 的 过 滤 也 不 会 影响 到 web 资 源 文件 。 


不 过 有 的 时 候 ， 我 们 可 能 希望 在 构建 项 目的 时 候 ， 为 不 同 的 客户 
使 用 不 一 样 的 资源 文件 (例如 客户 的 logo 图 片 不 同 ， 或 者 css 主 题 不 
mJ) 。 这 时 可 以 在 web 资 源 文 件 中 使 用 Maven 属 性 ， 例 如 用 $ 
{client.logo} 表 示 客 户 的 logo 图 片 ， 用 $ {alienttheme} 表 示 客 户 的 css 主 
题 。 然 后 使 用 profile 分 别 定 义 这 些 Maven 属 性 的 值 ， 如 代码 清单 14-18 所 


修 ° 


代码 清单 14-18 针对 不 同 客户 web 资 源 的 profile 


<profiles > 
<profile > 
<id>client -a</id> 
<properties > 
<client. logo >a. jpg < /client.logo > 
<client,. theme >red < /client. theme > 
< /properties > 
< /profile > 
<profile> 
<id>client -b</id> 
<properties > 
<client.logo >b. jpg < /client.logo > 
<client, theme >blue < /client. theme > 
< /properties > 
< /profile> 
< /profiles > 


最 后 需要 配置 maven-war-plugin 对 src/main/webapp/ 这 一 web 资 源 目 
录 开 启 过 滤 ， 如 代码 清单 14-19 所 示 。 


y 


代码 清单 14-19 ”为 web 资 源 目 录 src/main/webapp/ 开 启 过 小 


<plugin > 
<groupId >org.apache.maven.plugins < /groupId > 
<artifactId >maven-war-plugin < /artifactId> 
<version >2.1 -beta -1 </version> 
<configuration > 
<webResources > 
< resource > 
< filtering >true < /filtering > 
<directory >srce/main/webapp < /directory > 
< includes > 
< include > * « /* .css < /include > 
<include > * * /* .js < /include > 
< /includes > 
< / resource > 
< /webResources > 
< /configuration > 
< /plugin> 


代码 清单 14-19 中 声明 了 web 资 源 目 录 src/main/webapp (这 也 是 默认 
的 web 资 源 目录 ) ， 然 后 配置 filtering 开 启 过 滤 ， 并 且 使 用 includes 指 定 
要 过 滤 的 文件 ， 这 里 是 所 有 css 和 js 文件 。 读 者 可 以 模仿 上 述 配置 添加 
额外 的 web 资 源 目 未 ， 选 择 是 否 开启 过 滤 ， 以 及 包含 或 者 排除 一 些 该 目 
孙 下 的 文件 * 


配置 完成 后 ， 可 以 选择 激活 某 个 profile 进 行 构建 ， 如 mvn clean 
install-Pclinet-a， 告 诉 web 资 源 文件 使 用 logo 图 片 a.jpg， 使 用 css 主 题 


red ° 


14.6 ”在 profile 中 激活 集成 测试 


很 多 项 目 都 有 大 量 的 单元 测试 和 集成 测试 ， 单 元 测试 的 粒度 较 
细 ， 运 行 较 快 ， 集 成 测试 粒度 较 粗 ， 运 行 比较 耗 时 。 在 构建 项 目 或 者 
做 持续 集成 的 时 候 ， 我 们 都 应 当 尽 量 运 行 所 有 的 测试 用 例 ， 但 是 当 集 
成 测试 比较 多 的 时 候 ， 高 频率 地 运行 它们 丈 会 变 得 不 现实 。 因 此 有 一 
种 更 为 合理 的 做 法 。 例 如 ， 每 次 构建 时 只 运行 所 有 的 单元 测试 ， 因 为 
这 不 会 消耗 太 多 的 时 间 (可 能 小 于 5 分 钟 ) ， 然 后 以 一 个 相对 低 一 点 的 
频率 执行 所 有 集成 测试 (例如 每 天 2 次 ) 。 


TestNG 中 组 的 概念 能 够 很 好 地 文 持 单 元 测试 和 集成 测试 的 分 类 标 
记 。 例 如 ， 可 以 使 用 如 下 的 标注 表示 一 个 测试 方法 属于 单元 测试 : 


@ Test (groups = {"unit"}) 
然后 使 用 类 似 的 标注 表示 某 个 测试 方法 为 集成 测试 : 
@ Test (groups = {"integration"}) 


使 用 上 述 方 法 可 以 很 方便 清晰 地 声明 每 个 测试 方法 所 属 的 类 别 。 
下 面 的 工作 就 是 告诉 Maven 默 认 只 执行 所 有 的 单元 测试 ， 只 在 特定 的 时 
候 才 执行 集成 测试 ， 见 代码 清单 14-20 所 示 。 


代码 清单 14-20 ”在 profile 中 配置 执行 TestrNG 测 试 组 


<project > 
«build > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-surefire-plugin < /artifactId > 
version >2.5 < /version > 
configuration > 
<groups >unit < /groups > 
< f/cont ee ion > 
/plugin: 
/plug jins > 
< /build> 
<profiles > 
<profile> 
<id>full</id> 
<build> 
<plugins > 
<plugin > 
< groupId >org. apache. maven. p] 
<artifactId >mave 


<groups >unit, integration < /groups > 
</configuration > 
</plugin > 
< /plugins > 
</build> 
/profile > 
< /profiles > 


<project > 


如 果 读 者 对 Maven 集 成 TestNG 不 熟悉 ， 请 先 回顾 10.7 节 。 代 码 清 单 
14-20 中 首先 配置 了 maven-surefire-plugin 执 行 unit 测 斌 组， 也 就 是 说 默认 
Maven 只 会 执行 单元 测试 。 如 果 想 要 执行 集成 测试 ， 就 需要 激活 full 
profile， 在 这 个 profile 中 配置 了 maven-surefire-plugin 执 行 unit 和 
integration 两 个 测试 组 。 


有 了 上 述 配 置 ， 用 户 就 可 以 根据 实际 情况 配置 持续 集成 服务 器 。 
例如 ， 每 隔 15 分 钟 检 查 源 码 更 新 ， 如 有 更 痢 则 进行 一 次 默认 构建 ， 即 


包含 单元 测试 。 此 外 ， 还 可 以 配置 一 个 定时 的 任务 。 例 如 ， 每 天 执 
以 包含 所 有 的 集成 测试 。 


Ae 


行 两 次 ， 执 行 一 个 激活 full profile 的 构建 ， 


从 该 例 中 可 以 看 到 ，profile 不 仅 可 以 用 来 应 对 不 同 的 构建 环境 以 保 
持 构 建 的 可 移植 性 ， 还 可 以 用 来 分 离 构建 的 一 些 较 耗 时 或 者 耗资 源 的 
行为 ， 并 给 予 更 合适 的 构建 频率 。 


47 4 


项 目 构建 过 程 中 一 个 常常 需要 面 对 的 问题 就 是 不 同 的 平台 环境 差 
异 ， 这 可 能 十 操 作 系 统 的 差异 、 开 发 平台 和 测试 平台 的 差异 、 不 同 客 
尸 之 间 的 差异 。 


为 了 应 对 这 些 差异 ，Maven 提 供 了 属性 、 资 源 过 滤 以 及 profile 三 大 
寺 性 。Maven 用 户 可 以 在 POM 和 资源 文件 中 使 用 Maven 属 性 表示 那些 
可 能 变化 的 量 ， 通 过 不 同 profile 中 的 属性 值 和 资源 过 滤 特 性 为 不 同 环 
境 执行 不 同 的 构建 。 


=e 


=| 


读者 需要 区 分 Web 项 目 中 一 般 资源 文件 和 web 资 源 文 件 ， 前 者 是 通 
过 maven-resources-plugin 处 理 的 ， 而 后 者 通过 maven-war-plugin 处 理 。 


本 章 还 详细 介绍 了 profile， 包 括 各 种 类 别 profile 的 特点 ， 以 及 激活 
profile 的 多 种 方式 。 除 此 之 外 ， 本 章 还 贯穿 了 几 个 实际 的 示例 ， 相 信 
它们 能 够 帮助 读者 理解 什么 才 是 灵活 的 构建 。 


第 15 章 ”生成 项 目 站 点 
本 章 内 容 
最 简单 的 站 点 
.丰富 项 目 信息 
:项 目 报告 插件 
. 自 定义 站 点 外 观 
-创建 自 定义 页 面 


-国际 化 


Maven 不 仅仅 是 一 个 目 动 化 构建 工具 和 一 个 依赖 管理 工具 ， 它 还 
能 够 帮助 聚合 项 目 信 息 ， 促 进 团 队 间 的 交流 。POM 可 以 包含 各 种 项 目 
言 息 ， 如 项 目 描述 、 版 本 控制 系统 地 址 、 缺 陷 跟踪 系统 地 址 、 许 可 证 
信息 、 开 发 者 信息 等 。 用 户 可 以 让 Maven 上 自动 生成 一 个 Web 站 点 ， 以 
Web 的 形式 发 布 这 些 信 息 。 此 外 ，Maven 社 区 提供 了 大 量 插件 ， 能 让 
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析 、 代 码 变更 等 。 本 草 详 细 介绍 如 何 生 成 Maven 站 点 ， 以 及 如 何 配置 
各 种 插件 生成 项 目 报告 。 读 完 本 章 ， 应 该 能 够 为 目 己 的 项 目 生 成 床 亮 
的 Maven 站 点 ， 更 便捷 、 更 快速 地 为 团队 提供 项 目 当前 的 状态 信息 。 


15.1 最 简单 的 站 点 


对 于 Maven 2 来 说 ， 站 点 生成 的 逻辑 是 Maven 核 心 的 一 部 分 。 鉴 于 
灵活 性 和 可 扩展 性 考虑 ， 在 Maven 3 中 ， 这 部 分 逻辑 已 从 核心 中 移 除 。 
由 于 此 设计 的 变动 ，Maven 3 用 户 必须 使 用 3.x 版 本 的 maven-site- 
plugin。 例 如 : 


<pluginManagement > 
<plugi 
<plugin > 
<groupid >org. apache. maven, plugins < /gro an Id > 
<artifactId >maven-site-plugin < /artifact 
<version >3.0-beta-l < /version > 
< /plugin> 
< /plugins > 
< /pluginManagement > 


Maven 2 用 户 则 应 该 使 用 maven-site-plugin 最 新 的 2.x 版 本 。 例 如 : 


<pluginManagement > 
<plugins > 


Bo ond 
<groupid >org. apache maven. plugins < /gr op] Id > 
<artifactId >maven-si ein </artifact > 


<version >2.1.1< /version > 
< /plugin > 
< /plugins 
< /pluginManagement > 


配置 了 正确 版 本 的 maven-site-plugin 之 后 ， 在 项 目下 运行 mvn site 就 


能 直接 生成 一 个 最 简单 的 站 点 ， 用 户 可 以 看 到 如 下 方 代码 所 示 的 命令 
行 输出 。 


site:site fexecution: default—cli}] 
No URL defined for "ehe pro oject-decor tion links will not be resolved 


ugin Management" report. 
cing "Mailing Lists" report 
ating "Continuous Integration" report. 


ing "Dependency 


y "Proje 


Management” report. 
ou 


[INFO] Generating "Project Summary" report. 
[INFO] Generat oe "Deper ier acy Convergence" report. 
INFO] Generating "Dependencies" report. 


待 Maven 运 行 完毕 后 ， 可 以 在 项 目的 target/site/ 目 隶 下 找到 Maven 生 
成 的 站 点 文件 ， 包 括 dependencies.html ` dependency-convergence.html ` 
index.html 等 文件 和 css、images 文 件 夹 。 读 者 能 够 从 这 些 文件 及 文件 夹 
的 名 字 中 猜 到 其 中 的 内 容 : css 和 images 文 件 夹 是 用 来 存放 站 点 相关 的 
图 片 和 css 文 件 的 ， 其 他 html 文 件 基本 对 应 了 一 项 项 目 信 息 ， 如 
dependencies.html 包 含 了 项 目 依 赖 信息 ，license.html 包 含 了 项 目 许可 证 
信息 。index.html 则 是 站 点 的 主页 面 ， 用 浏览 器 打开 就 能 看 到 图 15-1 所 
示 的 页 面 。 


从 图 15-1 中 可 以 看 到 ， 左 边 导 航 栏 的 下 方 包含 了 各 类 项 目 信 息 的 链 
接 ， 包 括 持 续集 成 、 依 赖 、 问 题 奶 躁 、 邮 件 列表 、 团 队 、 源 码 库 等 


如 果 这 是 一 个 聚合 项 目 ， 导 航 栏 的 上 方 还 会 包含 子 模块 的 链接 ， 
但 是 如 来 单 击 这 些 链接 ， 将 无 法 转 到 了 于 模块 的 项 目 页 面 。 这 古 由 于 多 
模块 Maven 项 目 本 身 的 目录 结构 导致 的 。 如 果 将 站 点 发 布 到 服务 器 上 


该 问题 会 目 然 消失 。 如 有 果 想 在 本 地 查看 结构 正确 的 站 点 ， 则 可 以 
maven-site-pluginH 鸭 stage 目 标 ， 将 站 点 预 发 布 至 某 个 本 地 临时 目录 下 。 
例如 : 


$ mvn site:stage DstagingDirectory =D: \tmp 


Account Parent 


| Last Published: 2010-07-14 Account Parent 


Modules 
Account Email About Account Parent 
Account Persist 
Account Captcha 
Account Service There is currently no description associated with this project. 
Account Web 
Project Documentation 
¥ Project Information 
About 


Continuous 
Integration 
Dependences 
Dependency 
Convergence 
Dependency 
Management 
Issue Tracking 
Mailing Lists 
Plugin Management 
Project License 
Project Summary 
Project Team 
Source Repository 


Built by: "imme. 
Maven 


图 15-1 最 简单 的 Maven 站 点 


上 述 命 令 表 示 生 成 项 目 站 点 ， 并 预 发 布 至 D: xmp 目 永 。 读 着 可 以 
到 该 目 永 下 找到 项 目 站 点 的 html 文 件 ， 父 子 模块 之 则 的 链接 也 是 可 用 
Ay ° 


回顾 7.2.4 玫 ， 我 们 知道 site 生 命 周 期 有 四 个 阶段 ， 它 们 分 别 为 pre- 
site、site、post-site 和 site-deploy。 其 中 ，pre-site 和 post-site 默 认 没有 绑 
定 任 何 插件 目标 ， 可 以 说 它们 是 预 留 给 用 户 做 一 些 站 点 生成 之 前 及 之 
后 的 处 理 的 ; site 阶 段 绑 定 到 了 maven-site-plugin 的 site 目 标 ， 该 目标 负 
贡生 成 项 目 站 点 ， 因 此 之 前 使 用 简单 的 mvn site 命 令 束 能 直接 生成 项 日 
站 点 ; site-deploy 目 标 绑 定 了 maven-site-plugin 的 deploy 目 标 ， 该 目标 负 
责 将 站 点 部 署 至 远程 服务 器 。 本 章 稍 后 会 详细 解释 自动 化 站 点 部 署 。 


15.2 ERAS 


15.10 PH LAS, EAN D P Maven E ne SIRS 
TRAE HER, ARLE HAE Amaven-project-info-reports-plugin#') 
插件 生成 的 。 在 Maven 3 中 ， 该 插件 的 配置 内 置 在 maven-site-plugin 中 ， 
而 在 Maven 2 中 ， 该 插件 的 配置 内 置 在 核心 源码 中 。 因 此 你 不 需要 任何 
配置 束 能 让 Maven 帮 你 生成 项 目 信 息 。 该 插件 会 基于 POM 配 荀 生成 下 
列 项 目 信 息 报 告 : 


.关于 (about) : 项 目 描 述 。 
:持续 集成 (Continuous Integration) : 项 目 持续 集成 服务 器 信息 。 


-依赖 (Dependencies) : 项 目 依赖 信息 ， 包 括 传递 性 依赖 、 依 赖 
图 、 依 赖 许可 证 以 及 依赖 文件 的 大 小 、 所 包含 的 类 数目 等 。 


RULE (Dependency Convergence) : 只 针对 多 模块 项 目 生 成 ， 
提供 一 些 依赖 健康 状况 分 机， 如 各 模块 使 用 的 依赖 版 本 是 否 一 致 、 项 
目 中 是 否 有 SNAPSHOT 依 赖 。 


-依赖 管理 (Dependency Management) : 基于 项 目的 依赖 管理 配置 
生成 的 报告 。 


JH) GEER (Issue Tracking) : 项 目的 问题 追踪 系统 信息 。 


-邮件 列表 (Mailing Lists) : 项 目的 邮件 列表 信息 。 


:插件 管理 (Plugin Management) : 项 目 所 使 用 插件 的 列表 。 


:项目 许可 证 (Project License) : 项 目 许 可 证 信息 。 


:项 目 概 述 (Project Summary) : 项 目 概述 包括 坐标 、 名 称 、 描 述 
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项目 团队 (Project Team) : 项 目 团队 信息 。 


源码 仓库 (Source Repository) : 项 目的 源码 仓库 信息 。 


上 述 有 些 项 是 根据 项 目 已 有 的 依赖 和 插件 配置 生成 的 。 例 如 ， 依 
赖 这 一 项 就 很 有 意思 ， 除 了 依赖 坐标 、 传 递 性 依赖 以 及 依赖 图 ， 可 以 
使 用 maven-dependency-plugin 生 成 的 信息 之 外 ， 报 告 还 有 依赖 文件 细 市 
的 信息 ， 这 里 详细 罗列 了 每 个 依赖 文件 的 名 称 、 大 小 、 所 包含 文件 数 
目 、 类 数目 、 包 数目 和 JDK 版 本 等 信息 ， 如 图 15-2 所 示 。 


依赖 相关 的 项 是 基于 POM 的 dependencies 和 dependencyManagement 
元 素 生 成 的 ， 类 似 地 ， 其 他 项 也 都 有 其 对 应 的 POM 元 素 。Maven 不 会 
凭空 生成 信息 ， 只 有 用 户 在 POM 中 提供 了 相关 配置 后 ， 站 点 才 有 可 能 
包含 这 些 信息 的 报告 。 为 了 让 站 点 包含 完整 的 项 目 信 息 ， 需 配置 
POM， 如 代码 清单 15-1 所 示 。 


Dependency File Details 


greenmail-1.3.1b.jar 194.61 kB 
commons-logging-1.1.1.jar 59.26 kB 
activation-1.1.jar 61.51 kB 
mail-1.4,1.jar 437.18 kB 
junit-4.7 jar 226.91 kB 
sif4j-api-1.3.1.jar 11.94 kB 
spring-beans-2.5.6.jar 476.84 kB 
spring-context-2.5.6.jar 465.76 kB 
spring-context-support-2.5.6.jar 94.61 kB 
spring-core-2.5.6.jar 278.80 kB 


2.26 MB 
compile; 8 compile: 1.83 MB compile: 1,432 compile: 1,264 compile: 110 
test: 3 test: 433.46 kB test: 462 test: 398 test: 44 


图 15-2 ”依赖 文件 细 市 报告 


代码 清单 15-1 包含 完整 项 目 信 息 的 POM 


<project xmlns = "http://maven. apache. org/POM/4.0.0" 
xmins:xsi = "http://www. w3.org2001 XMLSchema-instance" 
xsi:schemaLocation ="http://maven. apache. org/POM/4.0.0 
http://maven. apache. org/maven-v4_0_0.xsd"> 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu. mvnbook. account < /groupId > 
<artifactId >account-parent < /artifactId> 
<version >1.0.0-SNAPSHOT < /version > 
< packaging >pom< /packaging > 
<name >Account Parent < /name > 
<url >http://mvnbook. juvenxu. com/< /url > 
<description >A project used to illustrate Mavens features. < /description > 


<scm> 
<connection >sem:svn:http://svn. juvenxu. com/mvnboook /trunk < /connection > 
< developerConnection >scm:svn:https://svn. juvenxu. com/mvnboook / trunk 
< /developerConnection > 
<url >http://svn. juvenxu. com/mvnboook /trunk < /url > 
</scm> 


<ciManagement > 

< system > Hudson < /system > 

<url >http://ci.juvenxu. com/mvnbook < /url > 
< /ciManagement > 


< developers > 
<developer > 
<id>juven< /id> 
<name >Juven Xu < /name > 
<email >juvenshun@ gmail.com< /email > 
<timezone >8 < /timezone > 
< /developer > 
< /developers > 


<issueManagement > 

<system>JIRA< /system> 

<url >http://jira. juvenxu. com/mvnbook < /url > 
< /issueManagement > 


< licenses > 
< license > 
<name >Apache License, Version 2.0 < /name > 
<url >http://www. apache. org/licenses /LICENSE2.0 < /url > 
< /license > 
< /licenses > 


< /project > 


代码 清单 15-1 中 使 用 scm 元 素 为 项 目 添加 了 源码 仓库 信息 ， 使 用 
ciManagement 元 素 为 项 目 添 加 了 持续 集成 服务 器 信息 ， 使 用 developers 


元 素 为 项 目 添加 了 项 目 成 员 团 队 信 息 ， 使 用 issueManagement 元 素 为 项 
目 添 加 了 问题 追踪 系统 信息 ， 使 用 licenses 元 素 为 项 目 添 加 了 许可 证 信 
息 。 这 时 再 重新 生成 站 点 ， 相 关 信 息 束 会 体现 在 站 点 的 项 目 信 息 报告 
中 。 图 15-3 就 显示 了 一 个 典型 的 源码 仓库 信息 报告 。 


Overview 


This project uses Subversion @ to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com 


Web Access 
The following is a link to the online source repository. 


m/mynboook/ trunk © 


Anonymous access 
The source can be checked out anonymously from SVN with this command: 


$ svn checkout http: //svn. juvenxu. com/mynboook/ trunk accoun: t-parent 


Developer access 


Everyone can access the Subversion repository via HTTP, but Committers must checkout the Subversion repository via HTTPS. 
$ svn checkout https: //svn. juvenxu. com/mynboook/trunk accoun t-parent 
To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password) 


$ svn commit —-username your-username -m “A message” 


图 15-3 项目 源码 仓库 信息 报告 


类 似 的 项 目 信息 报告 读者 可 以 在 很 多 的 开源 项 目 中 看 到 ， 使 用 
Maven 站 点 来 一 致 化 开源 项 目的 信息 展现 方式 无 疑 为 用 户 获取 信息 提供 
了 便利 。 


有 些 时 候 ， 用 户 可 能 不 需要 生成 某 些 项 目 信 息 项 ， 例 如 你 可 能 没 
有 邮件 列表 或 者 不 想 在 站 点 中 公开 源码 仓库 信息 ， 这 时 可 以 配置 


maven-project-info-reports-plugin 选 择 性 地 生成 信息 项 ， 如 代码 清单 15-2 
所 示 。 


代码 清单 15-2 ”选择 性 地 生成 项 目 信息 报告 


g.apache. maven. plugins < /qroupId > 
n-project-info-reports-plugin < /artifactId > 
< ye version > 


<report pe dencies < /report > 
<report >pro 


< report > (E e-t racking 
<report >license < /report > 
‘reports > 

ortSet > 


上 述 代 码 配 置 了 maven-project-info-reports-plugin。 需 要 注意 的 是 ， 
项 目 报告 插件 需要 在 reporting 元 素 下 的 plugins 元 素 下 进行 配置 ， 下 一 
还 将 介绍 其 他 项 目 报 告 插件 ， 也 都 在 这 里 进行 配置 。 代 码 清单 15-2 中 的 
配置 使 得 站 点 的 项 目 信息 只 包 仿 依赖、 团队、 问题 退 踪 系统 和 许可 证 
几 项 信息 ， 读 者 可 以 根据 自己 的 实际 情况 选择 要 生成 的 项 目 信 息 。 


15.3 ”项目 报 告 插件 


除了 默认 的 项 目 信 息 报 告 ，Maven 社 区 还 提供 了 大 量 报告 插件 ， 
只 要 稍 加 配置 ， 用 户 就 能 让 Maven 自 动 生 成 各 种 内 容 丰 富 的 报告 。 下 
面 介绍 一 些 比较 常用 的 报告 插件 。 值 得 注意 的 是 ， 报 告 插件 在 POM 中 
配置 的 位 置 与 一 般 的 插件 配置 不 同 。 一 般 的 插件 在 <project><build> 
<plugins> 下 配置 ， 而 报告 插件 在 <project><reporting><plugins> 下 配 
= 


15.3.1 JavaDocs 


这 可 能 是 最 人 简单、 也 最 容易 理解 的 报告 插件 了。maven-javadoc- 
plugin 使 用 JDK 的 javadoc 工 具 ， 基 于 项 目的 源 代 码 生成 JavaDocs 文 档 。 


该 插件 的 配置 如 代码 清单 15-3 所 示 。 
代码 清单 15-3 配置 maven-javadoc-plugin 插 件 


<reporting> 
<plugins > 
<plugin> 


<groupId >org.apache.maven.plugins < /groupId > 
<artifactIid >maven-javadoc-plugin < /artifactId> 
<version >2.7 </version> 


</plugin > 


< /plugins > 


< /reporting > 


基于 上 述 商 单 的 配置 ， 当 用 户 使 用 mvn site 命 令 生 成 站 点 时 ， 


得 到 项 目 主 源码 和 测试 源码 的 JavaDocs 文 档 ， 如 图 15-4 所 示 。 


LAG 


Account Captcha 


Last Published: 2010-07-18 Account Captcha 


Project Documentation 
> Project Information Generated Reports 
z Eroe Reger 


est JavaDocs This document provides an overview of the various reports that are 


Built by “tm, automatically generated by Maven m Each report is briefly described 
Maven below. 


Overview 


JavaDocs JavaDoc API documentation. 


Test JavaDocs Test JavaDoc API documentation. 


图 15-4 插件 报告 列表 


图 15-4 左 侧 的 导航 栏 有 两 个 类 别 ，Project Information), T 15.27 
讲述 的 各 类 基本 信息 ，Project Reports 则 包含 其 他 插件 生成 的 报告 。 这 
里 能 看 到 maven-javadoc-plugin 生 成 JavaDocs 和 Test JavaDocs 文 档 ， 单 击 
相应 链接 就 能 查看 具体 文档 ， 如 图 15-5 所 示 。 


所 有 类 = 

AccountCaptchaException 软件 包 Esta 树 已 过 时 索引 帮助 

AccountCaptchaService 上 一 个 类 下 一 个 类 框架 JEg 
AccountCaptchaServicelmp! 摘要 : RE | 字段 | 构造 方法 | 方法 详细 信息 : 字段 | 构造 方法 | 方法 
RandomGenerator 


con. juvenxu. mynbook. account. captcha 


接口 AccountCaptchaService 
所 有 已 知 实现 类 : 


AccountCaptchaServicelmpl 


public interface AccountCaptchaService 


generateCaptchaImage (String captchaKey) 
Str 
at 


at 
i enerateCaptchakey() 

getPreDefinedTexts() 
void) setPreDefinedTexts(List<String> preDefinedTexts) 


a tcha(String captchaKey, String captchaValue) 


图 15-5 JavaDocs C4 


FEE BOT A SCR, MDL alee: APEERE 
望 在 聚合 项 目 一 次 性 生成 融合 了 所 有 模块 信息 的 文档 ， 而 不 十 为 每 个 
模块 单独 生成 ， 原 因 束 古 为 了 方便 。 用 户 辟 古 布 户 在 一 个 地 方 看 到 尽 
可 能 全 面 的 信息 ， 而 非 不 停 地 单 击 链接 。 幸 运 的 是 ，maven-javadoc- 
plugin 考 虑 到 了 这 一 点 ， 使 用 该 插件 的 最 新 版 本 ， 用 户 无 须 任何 额外 的 
配置 ， 就 能 在 聚合 项 目的 站 点 中 得 到 包含 所 有 模块 的 JavaDocs， 配 置 见 
代码 清单 15-3。 


15.3.2 Source Xref 


如 果 能 够 随时 随地 地 打开 浏览 器 访问 项 目的 最 新 源 代码 ， 那 无 疑 
会 方便 团队 之 间 的 交流 。maven-jxr-plugin 能 够 帮助 我 们 完成 这 一 目 
标 ， 在 生成 站 点 的 时 候 配 置 该 插件 ，Maven 束 会 以 Web 页 面 的 形式 将 
Java 源 代码 展现 出 来 。 该 插件 的 配置 如 代码 清单 15-4 所 示 。 


代码 清单 15-4 配置 maven-jxrplugin 插 件 
< groupId >org.apache.maven.plugins < /groupId > 


<artifactid >maven-jxr-plugin < /artifactId> 
‘version >2.2 < /version> 


若 想 在 聚合 模块 整合 所 有 的 源码 ， 则 需 添 加 额外 的 aggregate 配 
置 ， 如 代码 清单 15-5 所 示 。 


代码 清单 15-5 ERAM H Bc Smaven-jxr-plugini (F 


<reporting > 
<plugins > 
<plugin > 
<groupid >org. apache. maven. plugins < /groupId > 
<artifactid >maven-jxr-plugin < /artifactid> 
<version >2.2 </version > 
< configuration > 
<aggregate >true < /aggregate > 
< /configuration > 
< /plugin > 


< /plugins > 
< /reporting > 


生成 的 源码 交叉 引用 报告 如 图 15-6 所 示 。 


在 这 个 源码 交叉 引用 文档 中 ， 所 有 源码 文件 都 通过 超 链 接 相 连 ， 
如 采 之 前 配置 了 JavaDocs 报 告 ， 用 户 还 能 直接 转 到 源码 文件 对 应 的 


JavaDoc ° 


All Classes View Javadoc 


Packages package com. juvenxu. mynbook, account. captcha; 
import java. awt. image. BufferedImage; 

import java. io. ByteArrayOutput Stream; 
import java. io. IOException: 

import java.util. HashMap; 

import java.util.List; 

import java. util. Map; 

import java.util. Properties; 


com juvenxu.mvnbook account captcha 


com juvenxu.mvnbook account email 
m nx k nt persi 
comian mmhnak account canica, 


All Classes - 
import javax. imageio. Imagel0; 


co hes | 


Account 
AccountCaptchaException 
hi 
AccountCaptchaServicelmp! 
AccountEmailException 
AccountEmailService 
AccountEmailServicelmp! 
AccountPersistException 
AccountPersistService 
AccountPersistServicelmp! 
AccountService 
AccountServiceException 
0 elmp! 
ActivateServiet 


CaptchalmageServiet 


import org. springframework. beans. factory. InitializingBean: 


lela 一 > eR ee eS 


on 


import com. google. code. kaptcha. impl. DefaultKaptcha; 
import com. google. code. kaptcha. util. Config: 


public class AccountCaptchaServiceImp] 


implements AccountCaptchaService, InitializingBean 
{ 


private DefaultKaptcha producer; 


private Map<String, String> captchaMap = new HashMap<String, String>(); 


private List<String> preDefinedTexts; 


private int textCount = 0; 


BREABBBEBEBKskk Els | 


public void afterPropertiesSet () 
throws Exception 
{ 


feo foo jea 
mi 一 已 


producer = new DefaultKapt cha(); 


a 


w 
EC 


RandomGenerator 


m 


图 15-6 ”源码 交叉 引用 文档 


15.3.3 CheckStyle 


CheckStyle 是 一 个 用 来 帮助 Java 开 发 人 员 遵 循 编码 规范 的 工具 ， 能 
根据 一 套 规则 自动 检查 Java 代 码 ， 使 得 团队 能 够 方便 地 定义 自己 的 编码 
规范 。 关 于 该 工具 的 详细 信息 可 以 访问 http://checkstyle.sourceforge.net/ 
进行 了 解 。 


要 让 Maven 在 站 点 中 生成 CheckStyle 报 告 ， 只 需要 配置 maven- 


checkstyle-plugin， 如 代码 清单 15-6 所 示 。 
代码 清单 15-6 ”配置 maven-checkstyle-plugin 揪 件 


< reporting > 
<plugins > 
< pl ugin> 
<groupid >org. apache. maven. plugins < /groupid > 
<artifactId >maven-checkstyle-plugin < /artifactId> 
<version >2.5 < /version > 


< /plugin > 


< /plugins > 


< /reporting > 


运行 mvn site 命 令 后 ， 葡 能 得 到 网 15-7 所 示 的 CheckStyle 报 告 。 


Checkstyle Results 


The following document contains the results of Checkstyle v. EE 


Summary 


4 


Files 


com/juvenxu/tr ok/account/persist/Account.java 


com/juvenxu/mynbook/account/persist/AccountPersistException.java 
com/juvenxu/mynbook/account/persist/AccountPersistService.java 
com/juvenxu/mynbook/account/persist/AccountPersistServiceImpl.java 


Rules 


JavadocPackage 

s allowLegacy: “true” 
NewlineAtEndOfFile 
Translation 


FileLength 
FileTabCharacter 


图 15-7 CheckStyle 报 告 


默认 情况 下 ，maven-checkstyle-plugin 会 使 用 Sun 定 义 的 编码 规范 ， 
读者 能 够 选择 其 他 预 置 的 规则 。 也 可 以 目 定义 规则 ，maven-checkstyle- 
plugin 内 置 了 四 种 规则 : 


:config/sun_checks.xml: Sun 定 义 的 编码 规范 GRE) ° 
-config/maven_checks.xml: Maven 社 区 定义 的 编码 规范 。 
:config/turbine_checks.xml: Turbine 定 义 的 编码 规范 。 


:config/avalon_checks.xml: Avalon 定 义 的 编码 规范 。 


用 户 可 以 配置 maven-checkstyle-plugin 使 用 上 述 编 码 规 范 ， 如 代码 
清单 15-7 所 示 。 


代码 清单 15-7 配置 maven-checkstyle-plugin 使 用 非 默认 编码 规范 


通常 用 户 所 在 的 组 织 会 有 自己 的 编码 规范 ， 这 时 就 需要 创建 自己 
的 checkstyle 规 则 文件 。 如 在 src/main/resources/ 目 录 下 定义 一 个 
checkstyle/my_checks.xml 文 件 ， 然 后 配置 
<configLocation>checkstyle/my_checks.xml</configLocation>B FJ ° 
maven-checkstyle-plugin 实 际 上 是 从 ClassPath 载 入 规则 文件 ， 因 此 对 于 
它 来 说 ， 无 论 规则 文件 是 在 当前 项 目 中 还 是 在 依赖 文件 中 ， 处 理 方式 
都 是 一 样 的 。 


对 于 多 模块 项 目 来 说 ， 使 用 maven-checkstyle-plugin 会 有 一 些 问 
题 。 首 先 ， (到 本 书 编写 为 止 ) maven-checkstyle-plugin 还 不 支持 报告 
聚合 。 也 就 是 说 ， 用 户 无 法 在 聚合 项 目的 报告 中 得 到 所 有 模块 的 


CheckStyle 报 告 。 想 要 在 各 个 模块 中 重用 目 定 义 的 checkstyle 规 则 还 需要 


一 些 额外 的 配置 。 具 体 过 程 如 下 : 


1) 创建 一 个 包含 checkstyle 规 则 文件 的 模块 : 


checkstyle/pom. xml 


checkstyle/src/main/resources /checkstyle/my-checks. xm 


2) 在 聚合 模块 配置 maven-checkstyle-plugin 依 赖 该 模块 : 


<build> 
<plugins > 
<plugin> 
<groupld >org. apache. maven. plugins < /groupId > 
<artifactId >maven-checkstyle-plugin < /artifactId > 
<version >2.5 < /version > 
< dependencies > 


< dependency > 


<groupid >com. juvenxu. mvnbook < /groupId > 
artifactId >checkstyle < /artifactId > 
<version >1.0 < /version > 
< /dependency > 
< /dependencies > 
< /plugin > 
< /plugins > 
< /build> 


3) 在 聚合 


模块 配置 maven-checkstyle-plugin 使 用 模块 中 的 checkstyle 
规则 : 


<reporting > 
<plugins > 
<plugin > 
<groupiId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-checkstyle-plugin < /artifactid > 
<version >2.5 </version > 
< configuration > 
<configLocation >checkstyle/my_checks.xml < /configLocation > 
< /configuration > 
< /plugin > 
< /plugins > 
< /reporting > 


RE ESE BIE PALS BE AUIS RR, PA RK ORT 
加 入 到 项 目的 ClassPath 中 ， 最 后 从 ClassPath 载 入 规则 文件 。 


15.3.4 PMD 


PMD 是 一 款 强 大 的 Java 源 代码 分 析 工 具 ， 它 能 够 寻找 代码 中 的 问 
包括 将 在 的 bug、 无 用 代码 、 可 优化 代码 、 重 复 代 码 以 及 过 于 复 灯 
的 表达 式 。 关 于 该 工具 的 详细 信息 可 以 访问 http:/pmd.sourceforge.net/ 进 
行 了 解 。 


要 让 Maven 在 站 点 中 生成 PMD 报 告 ， 只 需要 配置 maven-pmd-plugin 
如 下 : 


<plugins > 
<plugin> 


<groupId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-pmd-plugin < /artifactId> 

c version >2.5 < /version > 
</plugin > 


a ns> 
< Vee porting 


(0) 


运行 mvn site 之 后 ， 束 能 得 到 图 15-8 所 示 的 PMD 报 告 


Project 

Documentation PMD Results 

» Project 

Information 

> Project Reports 
Checkstyle 
CPD Report 
JavaDocs . 
PMD Report Files 
Source Xref 
Test JavaDocs 
Test Source Xref 


The following document contains the results of PMD 4.2.5. 


com/juvenxu/mvnbook/account/persist/AccountPersistServiceImpl.java 


Error while parsing D:\git-juven\maven-book\code\ch-15\account-aggregator\account- 
persist\src\main\java\com\juvenxu\mvnbook\account\persist\AccountPersistServiceImpl.java: Can't 
use annotations when running in JDK 1.4 mode! 

Error while parsing D;\git-juven\maven-book\code\ch-15\account-aggregator\account- 
persist\src\main\java\com\juvenxu\mvnbook\account\persist\AccountP ersistServiceImpl.java: Can't 
use annotations when running in JDK 1.4 mode! 

Error while parsing D:\git-juven\maven-book\code\ch-15\account-aggregator\account- _ 
persist\src\main\java\com\juvenxu\mvnbook\account\persist\AccountPersistServiceImpl.java: Can't 
use annotations when running in JDK 1.4 mode! 


图 15-8 PMD 报告 


需要 注意 的 是 ， 除 了 PMD 报 告 之 外 ，maven-pmd-plugin 还 会 生成 一 
个 名 为 CPD 的 报告 ， 该 报告 中 包含 了 代码 拷贝 粘贴 的 分 析 结 果 。 


PMD 包 含 了 大 量 的 分 析 规 则 ， 读 者 可 以 访问 
http://pmd.sourceforge.net/rules/index.html 查 看 这 些 规则 。PMD 默 认 使 用 
的 规则 为 rulesets/basic.xml ` rulesets/unusedcode.xml il 
rulesets/importss.xml。 要 使 用 其 他 的 规则 ， 可 以 配置 maven-pmd-plugin 
插件 ， 如 代码 清单 15-8 所 示 。 


代码 清单 15-8 配置 maven-pmd-plugin 使 用 非 默认 分 析 规 则 


<reporting > 
<plugins > 
<plugin > 
<groupiId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-pmd-plugin < /artifactid> 
<version >2.5 </version> 
<configuration > 
<rulesets > 
<ruleset >rulesets/braces. xml < /ruleset > 
<ruleset >rulesets /naming. xml < /ruleset > 
< ruleset >rulesets/strings. xml < /ruleset > 
< /rulesets > 
< /configuration > 
< /plugin > 
< /plugins > 
< /reporting > 


maven-pmd-plugin 文 持 聚 合 报告 ， 只 需要 如 下 配置 aggregate 参 数 即 


< reporting > 
<plugins > 
<plugin > 
<groupId >org. apache. maven. plugins < /groupId > 
<artifactid >maven-pmd-plugin < /artifactId> 
<version >2.5 < /version> 
<configuration > 
<aggregate >true < /aggregate > 
< /configuration > 
< /plugin> 
< /plugins > 
< / reporting > 


15.3.5 ChangeLog 


maven-changelog-plugin 能 够 基于 版 本 控制 系统 中 就 近 的 变更 记录 
生成 三 份 变 更 报告 ， 它 们 分 别 为 : 


‘Change Log: 基于 提交 的 变更 报告 ， 包 括 每 次 提交 的 日 期 、 文 
件 、 作 者 、 注 释 等 信息 。 


‘Developer Activity: 基于 作者 的 变更 报告 ， 包 括 作 者 列表 以 及 每 
个 作者 相关 的 提交 次 数 和 涉及 文件 数目 。 


File Activity: 基于 文件 的 变更 报告 ,包括 变 更 的 文件 列表 及 每 个 
IFE EK BEL © 


想 要 生成 项 目的 变更 报告 ， 首 先 需 要 配置 正确 的 SCM 信 息 赔 ， 如 
P: 


<project > 


<scm> 
<connection >scm:svn:http://192.168.1.103 /app/trunk «< /connection > 
< developerConnection >scm:svn:https://192.168.1.103 /app/trunk < /develo- 
perConnection > 
<url > http://192.168.1.103 /account /trunk < /url > 


有 了 SCM 配 置 ， 就 可 以 配置 maven-changelog-plugin 生 成 变更 报 
告 ° 如 下 : 


< reporting > 
<plugins > 
<plugin > 
<groupiId >org. apache. maven. plugins < /groupId > 
<artifactId >maven-changelog-plugin < /artifactId> 
<version >2.2 < /version > 
< /plugin > 
< /plugins > 
< /reporting > 


生成 的 变更 报告 如 图 15-9 所 示 。 


默认 情况 下 ，maven-changelog-plugin 生 成 最 近 30 天 的 变更 记录 ， 
不 过 用 户 可 以 修改 该 默认 值 。 如 下 : 


Change Log Report 


Total number of changed sets: 1 


Changes between 2010-04-28 and 2010-05-29 


Total commits: 12 
Total number of files changed: 8 


[Timestamp |Author | Details OO 


2010-05-25 Dennis /maven/plugins/tags/maven-changelog-plugin-2.2 @ v 948185 © 
21:21:19 Lundberg 


[maven-scm] copy for tag maven-changelog-plugin-2 9.2 
/maven/plugins/trunk/maven-changelog-plugin/pom.xml @ v 948184 © 


[maven-release-plugin] prepare release maven-changelog-plugin-2 0.2 


2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml m v 948176 w 
21:11:51 Lundberg 


2010-05-25 Dennis 
21:21:07 Lundberg 


Upgrade to maven-plugins parent 18. 
2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml o v 948173 @ 


21:08:46 Lundber 
Add used but undeclared dependencies. 


2010-05-25 Dennis /maven/plugins/trunk/maven-changelog-plugin/pom.xml @ v 948152 © 
20:24:39 Lundberg 
Remove element that was mistakenly added in r890138. 


eae hboutemy = /maven/plugins/trunk/maven-changelog-plugin/pom.xml © v 943737 © 
1:44:31 


图 15-9 ”变更 报告 


< reporting > 
<plugins > 
<plugin> 
<groupId >org. apache. maven.plugins < /groupid > 
<artifactid >maven-changelog-plugin < /artifactId> 
<version >2.2 </version> 
< configuration > 
<type >range < /type > 
< range >60 < /range > 
< /configuration > 
< /plugin > 
< /plugins > 
< /reporting > 


(1) 如 果 不 熟 悉 该 配置 ， 可 以 回顾 13.4 节 。 


15.3.6 Cobertura 


10.6.2 0 22477260 Cobertura E BQ ist 78 eI A, MENAN 
何 将 该 报告 集成 到 项 目 站 点 中 。 


要 在 Maven 站 点 中 包含 Cobertura 测 试 覆 盖 率 报告 ， 只 需要 配置 


cobertura-maven-plugin。 如 下 : 


<reporting > 
<plugins > 
<plugin > 
<groupid >org. codehaus. mojo < /groupid > 
<artifactId >cobertura-maven-plugin < /artifactId> 
<version >2.4 < /version > 
</plugin > 
< /plugins > 
< /reporting > 


生成 的 Cobertura 测 试 覆 盖 率 报告 如 图 15-10 所 示 。 


Packages Coverage Report - com.juvenxu.mvnbook.account.captcha 
All 
com. juvenxu.mvnbook.account.captch: Package ‘ # Classes Line Coverage Branch Coverage Complexity 


venxu.mynbook. nt. 4 78% > 36/46 W 75% 9/12 B 1.8 


Classes in this Package ‘ Branch Coverage Complexity 
AccountCaptchaException N/A 


z : AccountCaptchaService | | N/A 
com.juvenxu.mvnbook.account.c 


A ni rviceImp! 7/10 E 
RandomGenerator 85% | 2/2 
Classes 


AccountCaptchaException (0%) Report generated by Cobertura 1.9.4.1 on 10-7-21 下 午 2:36, 


AccountCaptchaService (N/A) 
AccountCaptchaServiceImp! (85%) 
RandomGenerator (85%) 


15-10 “Cobertura 测 试 覆 盖 率 报告 


可 以 从 图 15-10 中 看 到 每 个 包 、 每 个 类 的 代码 行 履 盖 率 和 分 文 敌 齐 
率 ， 单 击 具体 的 类 还 能 看 到 该 类 代码 的 具体 履 盖 情况 。 可 惜 的 是 ， 到 
本 书 编写 时 为 止 ，cobertura-maven-plugin 还 不 文 持 报告 聚合 ， 因 此 用 户 
无 法 在 聚合 模块 查看 所 有 模块 的 测试 窗 新 情况 。 


15.4” 目 定义 站 点 外 观 


Maven 生 成 的 站 点 非 第 灵活 ， 除 了 本 革 前 面 提 到 的 标准 项 目 信息 
报告 和 其 他 插件 生成 的 报告 ， 用 户 还 能 够 目 定义 站 点 的 布局 和 外 观 。 
这 些 特性 能 让 用 户 创建 出 更 适合 目 己 的 ， 更 有 个 性 的 Maven 站 点 。 


15.4.1 站 点 描述 符 


要 自 定义 站 点 外 观 ， 用 户 必须 创建 一 个 名 为 site.xml 的 站 点 描述 符 
文件 ， 且 默认 该 文件 应 该 位 于 项 目的 src/site 目 录 下 。 该 站 点 摘 述 从 文件 
是 由 XML Schema 约 束 定 义 的 ， 相 关 的 xsd 文 件 位 于 


http://maven.apache.org/xsd/decoration-1.0.0.xsd ° 
一 个 简单 的 站 点 描述 符 文 件 如 代码 清单 15-9 所 示 。 
代码 清单 15-9 ”站 点 描述 符 文件 


<?xml version = "1.0" encoding = "UTF-8"?> 
<project xmins = "http://maven. apache. org/DECORATION/1.0.0" 
"http://www. w3.org/2001 /XMLSchema-instance" 


xmins:xsi = 
"http://maven. apache. org /DECORATION/1.0.0 


xSi:schemaLocation 
http://maven. apache. org/xsd/decoration-1.0.0.xsd" > 
<bannerLeft > 
<name >Account < /name > 
<src > images /apache-maven-project.png < /sre > 
<href >http://maven. apache. org < /href > 


< /bannerLeft > 


< body > 
<menu ref = "reports"/ > 
< /body > 
<skin > 
<groupId >com. googlecode. fluido-skin < /groupId > 
<artifactid >fluido-skin < /artifactId> 
<version >1.3 < /version > 
< /skin > 
< /project > 


WATE AS SCPE ESOT Pu Shs AAEE 
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mt 


15.4.2” 头 部 内 容 及 外 观 


默认 情况 下 ，Maven 站 点 的 标题 来 目 于 POM 中 的 name 元 妹 值 ， 用 
户 可 以 配置 站 点 描述 符 project 元 系 的 name 属 性 来 更 改 此 标题 。 如 下 : 


<project name =" A Project for Maven Book" > 


< /project > 


显示 效果 如 图 15-11 所 示 。 


A Project for Maven Book - Generated Reports 


|) A Project for Maven B... 


€ © r file:///D:/git-juven/maven-book/cq 


图 15-11 目 定 义 站 点 标题 的 效果 


如 采 不 进行 额外 的 配置 ， 站 点 头 部 左边 会 显示 项 目的 名 称 ， 但 是 
用 户 可 以 使 用 bannerLeft 元 素 配 置 该 位 置 显 示 目 定义 的 横幅 图 片 。 类 似 
地 ，bannerRight 元 素 能 用 来 配置 显 式 在 头 部 右边 的 横幅 图 片 。 具 体 配 
EUP: 


poek > 
<bannerLeft > 
<name >maven < /name > 
<srce>http://maven. Toe yy ‘apache-maven-project.png</sre> 


<href >http://maven.apac org < /href > 
< /bannerLeft > 
<bannerRight > 
< name : 和 
Egg 


<href >http://www. java.com< /href > 
< /bannerRight > 
< /project > 


上 述 代码 为 头 部 配置 了 两 个 横幅 图 片 ， 左 边 的 图 片 直接 引用 了 
Maven 站 点 ， 而 右边 则 使 用 了 本 地 图 片 。 显 示 效 果 如 图 15-12 所 示 。 


a Apache Maven Project 


http://maven.apache.org/ 


Last Published: 2010-07-23 


图 15-12 ”站 点 头 部 横幅 图 片 显 示 歼 果 


需要 注意 的 是 ， 上 述 Java 图 片 的 src 为 images/java.jpg， 是 一 个 本 地 
图 片 ， 所 有 站 点 使 用 的 本 地 Web 资 源 都 必须 位 于 src/site/resources 目 条 
下 。 到 目前 为 止 ， 该 站 点 的 目录 结构 是 这 样 的 : 


-srce/ 
+ Site/ 
+ resources / 
| + images/ 
| + java. jpg 
| 


+ site. Xml 


除了 标题 和 头 部 横幅 图 片 外 ，Maven 用 户 还 能 够 配置 是 否 显示 站 点 
的 最 近 发 布 时 间 和 有 版本。 如 下 : 


<project > 
<version position = "right"/> 
<publishDate position = "right"/> 


a OR 
< / projec t> 


这 里 的 position 可 用 的 值 包括 none 、left 、right 、navigation-top 、 
navigation-bottom 和 bottom， 它 们 分 别 表示 不 显示 、 头 部 左边 、 头 部 右 


边 、 导 航 边 栏 上 方 、 导 航 边 栏 下 方 和 底部 。 
Maven 丫 点 还 文 持 面包 悄 导 航 。 相 关 配 置 如 下 : 


<project > 
< body > 
< breadcrumbs > 
<item name = "Maven" href = "http://maven. apache. org"/> 
<item name = "Juven Xu" href = "http://www. juvenxu,. com"/> 
< /breadcrumbs > 
< / body > 


< /project > 


显示 效果 如 图 15-13 〈 图 中 还 包括 了 发 布 日 期 和 版 本 ) 所 示 。 


一 一 
< 


Java 
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15.4.3 ”皮肤 


如 琳 沉 得 目 定 义 站 点 标题 、 横 幅 图 片 和 面包 悄 导 航 等 内 容 还 无 法 
满足 自己 的 个 性 化 需求 ， 这 时 也 许可 以 考虑 选择 一 款 非 默认 的 站 点 皮 
肤 ， 以 将 目 己 的 站 后 与 其 他 站 点 很 明显 地 区 分 开 来 。 


目 定义 站 点 度 肤 分 为 两 步 : 第 一 步 旦 选择 要 使 用 的 站 点 皮肤 构 
件 ， 第 二 步 是 配置 站 点 摘 述 符 的 skin 元 素 使 用 该 构件 。 


Maven 官 方 提供 了 三 款 皮 肤 ， 它 们 分 别 为 : 
‘org.apache.maven.skins:maven-classic-skin 

-org.apache.maven.skins.maven-default-skin 

-org.apache.maven.skins.maven-stylus-skin 


其 中 ，maven-default-skin 是 站 点 的 默认 皮肤 ， 读 者 可 以 访问 中 央 仓 
库 以 了 解 这 些 皮肤 的 最 新 版 本 0 。 


除了 官方 的 皮肤 ， 互 联网 上 还 有 大 量 的 第 三 方 用 户 创建 的 站 点 皮 
肤 。 这 里 笔者 要 介绍 一 蒜 托 管 在 GoogleCode 上 的 名 为 fluido-skin 的 皮 
肤 ， 它 非常 清爽 、 人 简洁， 读者 可 以 访问 该 项 目 主 页 了解 其 最 新 的 版 
本 o 


下 面 承 以 ftuido-skin 为 例 ， 配 置 站 点 皮肤 。 编 辑 site.xml 如 下 : 


<project > 
<skin > 
< groupId >com. googlecode. fluido-skin < /groupId > 
<artifactid > fluido-skin < /artifactId> 
< version >1.3 < /version > 
< /skin> 
< /project > 


J | 


图 15-14 显 示 了 使 用 了 fluido-skin 皮 肤 后 的 站 点 显示 效果 ， 看 起 来 与 
默认 的 皮肤 感觉 很 不 一 样 。 


Apache Maven Project 


一 http://maven.apache.org/ 
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Project Generated Reports 
Documentation 
"Project information This document provides an overview of the various reports that are automatically generated by Maven ™ Each 
“Project Reports report is briefly described below. 
Checkstyle 
Cobertura Test 
Seis Overview 
CPD Report 
JavaDocs 
PMD Report £ i cripti 
Source Xref Checkstyie Report on coding style conventions. 


Test JavaDocs Cobertura Test Coverage Cobertura Test Coverage Report. 
Test Source Xref 


CPD Report Duplicate code detection. 


Built by: “Ww A 
Maven JavaDocs JavaDoc AP! documentation. 


PMD Report Verification of coding rules. 


Source Xref HTML based, cross-reference version of Java source code, 
Test JavaDocs Test JavaDoc API documentation. 


Test Source Xref HTML based, cross-reference version of Java test source code. 


Copyright © 2010. All Rights Reserved, 


图 15-14 使 用 了 fluido-skin 皮 肤 的 站 点 


[1] 请 参考 : http://repo1.maven.org/maven2/org/apache/maven/skins/ ° 


[2] 请 参考 : http://code.google.com/p/fluido-skin/ ° 


15.4.4 .导航 边栏 


如 采用 户 不 目 定义 站 点 描述 符 文 件 ， 页 面 左 边 的 边 们 只 会 显示 包 
舍 项 目 信 息 报告 和 其 他 报告 的 菜单 。 然 而 该 导航 栏 内 容 也 是 能 够 自 定 
义 的 ,用户 可 以 在 这 里 创建 其 他 沫 单 。 


要 在 导航 边栏 加 入 自 定 义 菜 单 ， 只 需要 编辑 站 点 描述 符 中 body 元 
素 下 的 menu 子 元 素 。 如 代码 清单 15-10 所 示 。 


代码 清单 ”15-10 


<menu name = " $ {project.name}" 
<item name = "Introducation" href ="introduction,.html"/> 
<item name = "Usage" href = "usage. htm1"/> 
<item name = "FAQ" href = "faq. html"/> 
< /menu > 
<menu name = “Examples" > 
<item name = "Example 1" href ="example_1.ht 
<item name = "Example 2" href = "example_2.ht 


"“reports"/> 


sn RAS EY = PSK, AAAS {projectname} ` Examples 


和 reports。 


第 一 个 菜单 名 称 使 用 了 Maven 属 性 ， 站 点 摘 述 从 中 的 Maven 属 性 会 
个 目 动 解析 至 对 应 的 值 。 因 此 这 里 的 $ {project.name} 在 站 点 中 会 被 显 


示 成 项 目 名 称 ， 该 菜单 包含 了 3 个 子 项 ， 分 别 为 Introduction、Usage 和 
FAQ， 每 个 子 项 链接 一 个 html 文 件 (15.5 市 将 介绍 如 何 创建 这 些 html 页 
面 ) 。 


二 个 菜单 名 称 是 Examples， 包 含 两 个 子 项 Example 1 和 Example 
2， 也 分 别 链接 两 个 html 页 面 。 


最 后 一 个 染 单 比较 特殊 ， 它 使 用 的 是 ref 属 性 而 非 name 属 性 ，ref 用 
来 引用 Maven 站 点 默认 生成 鸭 页 面 。 例 如 ， 这 里 的 reports 表 示 引 用 项 目 
报告 菜单 。 除 此 之 外 ， 还 有 两 个 可 用 的 ref 值 ，parent 表 示 包 含 父 模块 链 
接 的 亲 单 ，modules 表 示 一 个 包公 所 有 了 于 模块 链接 的 瑟 单 。 


基于 代码 清单 15-10 生 成 的 站 点 如 图 15-15 所 示 。 


Account Captcha Generated Reports 
Introducation 
Lae This document provides an overview of the various reports that are automatically generated by Maven © Each report is briefly 
FAQ described below 

Examples 
Cm 1 
Example Overview 

Project Docimentation 

oject Info 


“Project ney 
Checkstyle Checks tyle Report on coding style conventions. 


Cobertura Test Coverage Cobertura Test Coverage Report. 

CPD Report Duplicate code detection. 

JavaDocs JavaDoc API documentation. 

PMD Report Verification of coding rules. 

Source Xref HTML based, cross-reference version of Java source code. 
Test JavaDocs Test JavaDoc API documentation. 


Test Source Xref HTML based, cross-reference version of Java test source code. 
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图 15-15” 自 定义 导航 边栏 菜单 


15.5 创建 目 定义 页 面 


15.4 世 介绍 了 如 何 自 定义 站 点 导航 菜单 并 链接 至 特定 的 html 页 面 ， 
本 蔬 介 绍 如 何 创建 目 定 义 的 站 点 页 面 。 到 目前 为 止 ，Maven 支 持 得 比较 
好 的 两 种 文档 格式 为 APT 和 FML ° 


APT (Almost Plain Text) 是 一 种 类 似 于 维基 的 文档 格式 ， 用 户 可 
以 用 它 来 快速 地 创建 简单 而 又 结构 丰富 的 文档 。 例 如 ， 创 建 一 个 对 应 
于 15.4.4 廊 提 到 的 introduction.html 的 APT 文 档 ， 首 先 要 记 住 的 是 ， 所 有 
APT 文 档 必须 位 于 src/site/apt/ 目 录 。 这 里 创建 文件 introduction.apt， 内 容 
见 代码 清单 15-11。 


代码 清单 15-11 创建 APT 文 档 


Apache Maven is a software project management and comprehension tool... 
Core Maven Concepts 
+ Coordinates and Dependency 

descriptions for maven coordinates and dependnecy... 
* Repository 

There are many kinds of repositories: 

* Local Repository 

* Central Repository 

* Internal Repository Service 


* Plugin and Lifecycle 


descriptions for maven plugin and lifecycle... 


代码 清单 15-11 的 第 一 部 分 是 标题 ， 它 们 必须 缩 进 ， 且 用 多 个 连 字 
号 相隔 。 在 接 下 来 的 内 容 中 , “What is Maven’? ”和 “Core Maven 


Concepts” 没 有 缩 进 ， 它 们 是 一 级 小 入 。“What is Maven? ”下 面 的 内 容 
有 缩 进 ， 表 示 一 个 段落 。 未 缩 进 的 且 以 星 号 开头 的 部 分 表示 二 级 小 
放 ， 因 此 上 述 代 码 中 有 Coordinate and Dependency、Repository 和 Plugin 
and Lifecycle 3 个 二 级 小 节 ， 它 们 都 包含 了 一 些 段 落 ， 其 中 Repository 下 
面 有 包含 三 个 项 的 列表 ， 它 们 用 缩 进 的 星 号 表示 。 


上 述 代 码 展示 了 如 何 编写 一 个 简单 的 APT 文 档 。 笔 着 没有 详细 介 
绍 所 有 APT 文 档 格式 的 语法 ， 如 果 读 者 有 需要 ， 可 以 参考 


http://maven.apache.org/doxia/references/apt-format.html ° 


上 述 APT 文 档 展 现 后 的 效果 如 网 15-16 所 示 。 


What is Maven? 


Apache Maven is a software project management and comprehension tool... 


Core Maven Concepts 


Coordinates and Dependency 


descriptions for maven coordinates and dependnecy... 


Repository 


There are many kinds of repositories: 
Local Repository 


es Central Reposito 
è Internal Repository Service 


Plugin and Lifecycle 


descriptions for maven plugin and lifecycle... 


图 15-16 ”APT 文 档 效 果 


FML (FAQ Markup Language) 是 一 种 用 来 创建 FAQ (Frequently 
Asked Questions, fi JL ae) 页 面 的 XML 文档 格式 ， 下 面 创建 一 
个 对 应 于 15.4.4 市 提 到 的 fag.html 页 面 的 FML 文 档 。 就 像 APT 文 档 需 要 放 
到 src/site/apt/ 目 隶 一样 ，FML 文 档 需 要 放 到 src/site/fm1l/ 目 录 。 在 这 里 创 
建文 件 fag.fml， 如 代码 清单 15-12 所 示 。 


代码 清单 15-12 ”创建 EML 文档 


<?xml version = "1.0" encoding = "UTF-8"?> 
< faqs xmlns = "http://maven. apache. org/FML/1.0.1" 
"http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "*http://maven. apache. org/FML/1.0.1 
http://maven. apache. org/xsd/fiml-1.0.1.xsd" 

title = "Frequently Asked Questions" 

toplink = "false" > 


xmins :xsi 


<part id="install"> 
<title>Install </title> 
< faq id = "download" > 
< question >Where to Download? < /question > 
<answer > 
<p >Maven: http://maven. apache. org/download. html </p> 
<p >Nexus: http://nexus. sonatype. org/downloadmexus. html < /p > 
< /answer > 
</faq> 
< fag id="do-install"> 
< question >How to Install? < /question > 
<answer > 


<p >Description on the installation steps... </p> 
< /answer > 


</fag> 
</part > 


<part id="run"> 
<title>Run</title> 
<faq id="how-install"> 
< question >How to Run?< /question > 
<answer > 
<p >Description on the installation steps... </p> 
< /answer > 
< /faq> 
< /part > 


< / faqs > 

上 述 XML 文 档 的 根 元 素 为 faqs， 该 元 素 的 title 属 性 定义 了 文档 的 标 
题 。 根 元 素 下面 使 用 part 元 素 定 义 了 两 个 文档 部 分 ， 第 一 个 是 install， 
第 二 个 是 run。 每 个 文档 部 分 有 自己 的 标题 ， 以 及 用 faq 元 素 定义 的 问题 


项 目 ，fadq 的 子 元 素 question 用 来 定义 问题 ， 子 元 素 answer 用 来 定义 答 
案 ， 这 种 结构 是 非常 清晰 的 。 同 样 地 ， 这 里 不 会 详细 解释 所 有 的 FML 


文档 语法 ， 如 果 有 需要 ， 可 以 访问 


http://maven.apache.org/doxia/references/fml-format.html ° 


上 上述 FML 文 档 展 现 后 的 效果 如 图 15-17 所 示 。 


Frequently Asked Questions 


Install 


1. Where to Download? 
2. How to Install? 


1. How to Run? 


Install 


Where to Download? 
Maven: http://maven.apache.org/download.html 


Nexus; http://nexus.sonatype.org/download-nexus.html 


How to Install? 


Description on the installation steps... 


Run 


How to Run? 


Description on the installation steps... 


图 15-17 FML 文 档 效果 


到 目前 为 止 ， 冰点 的 目录 结构 如 下 : 


-src/ 
+ site/ 

+ resources/ 
| + images/ 
| + java.jpg 
| 
+ apt/ 
| + introduction. apt 
| 
+ iml/ 
| + £q1.f£ml1 
| 


+ Site.xml 


15.6 ”国际 化 


对 于 广大 欧美 以 外 的 用 户 来 说 ， 站 点 上 难免 需要 添加 一 些 本 土 的 
文字 ， 如 琳 没 有 特殊 的 配置 ， 站 点 可 能 无 法 对 其 使 用 正确 的 子 符 集 编 
码 。 本 和 以 简体 中 文 为 例 ， 介 绍 如 何 生 成 本 地 化 的 Maven 站 点 。 


要 生成 正确 的 简体 中 文 站 点 ， 用 户 首先 需要 确保 项 目 所 有 的 源 
码 ， 包 括 pom.xml、site.xml 以 及 apt 文 档 等 ， 都 以 UTF-8 编 码 保存 ， 各 种 
编辑 硕 和 IDE 部 支持 用 户 指 定 你 存 文档 的 编码 。 图 15-18 束 展示 了 
Windows 上 用 记事 本 保存 文档 时 候 如 何 指定 UTF-8 编 码 。 


了 SBA 


g- « src » site » -|4| |27 p| 


)) resources 


L „settings 
j STC 

» main 
site 


图 15-18 用 记事 本 保存 文档 时 指定 UTF-8 编 码 


接 下 来 要 做 的 是 告诉 maven-site-plugin 使 用 UTF-8 编 码 读 取 所 有 源 
码 及 文档 ， 并 且 同 样 使 用 UTF-8 编 码 呈 现 站 点 html 文 档 。 这 两 点 可 以 通 
过 配置 两 个 Maven 属 性 实现 ， 如 下 : 


< properties > 
<project. build. sourceEncoding >UTF-8 < /project. build. sourceEncoding > 


<project .reporting.outputEncoding >UTF-8 </project .reporting.outputEncoding > 
< /properties > 


project.build.sourceEncoding 属 性 用 来 指定 Maven 用 什么 编码 来 读 取 
源码 及 文档 ， 而 project.reporting.outputEncoding 用 来 指定 Maven 用 什么 
编码 来 呈现 站 点 的 html 文 档 。 


最 后 一 步 要 做 的 是 配置 maven-site-plugin 指 定 当 地 的 语言 ， 配 置 当 
地 语言 为 简体 中 文 zh_CN。 如 下 : 


<plugins > 


<plugin > 
<groupľd >org. apache. maven. plugins < /groupId > 
<artifactId >maven-site-plugin < /artifactId > 
<version >2.1.1</version> 
<configuration > 
< locales > zh_CN < /locales > 
< /configuration > 


</plugin > 


<plugins > 


完成 这 些 配置 后 ， 束 能 生成 图 15-19 所 示 的 中 文 站 后 。 


Account Captcha 


最 近 更 新 : 2010-07-27 | 版 本 : 1.0.0 SNAPSHOT 
队 


一 个 成 功 的 项 目 要 求 许多 人 扮 满 许 多 的 角色 * 其 中 一 些 成 员 编写 代码 或 者 文档 ， 同 时 其 他 成 员 则 通过 负 试 、 打 补丁 以 及 
提 建 说 等 方式 实现 自己 的 价值 。 


一 个 团队 由 团队 成 员 以 及 贡献 者 组 成 。 团队 成 员 直接 访问 项 目的 源 代码 并 积极 地 参与 编码 工作 。 页 献 者 则 通过 向 成 员 提 


交 补 丁 和 提出 建议 来 完善 项 目 。 一 个 项 目 中 贡献 者 的 数量 是 不 限 的 * 请 立刻 加 入 到 贡献 行列 中 来 吧 。 束 心 感谢 所 有 对 项 
目 做 出 贡献 的 人 。 


成 员 


以 下 是 开发 者 的 列表 ， 他 们 有 提交 的 权限 ， 在 项 目 中 以 某 种 方式 直接 散 出 了 贡献 。 


ME | 


juven Juven Xu juvenshun@gmail.com ~ 8 Tue Jul 27 2010 17:55:38 GMT+0800 (China Standard Time) 


贡献 者 


本 项 目 没有 根 关 贡 献 者 。 请 以 后 再 查看 。 


图 15-19 生成 中 文 Maven 站 点 


15.7 部署 站 点 


为 了 方便 团队 和 用 户 得 到 必要 的 项 目 信息 


时.， 我 们 需要 将 Maven 站 点 
部 署 到 服务 右上 “。Maven 文 持 多 种 协议 部 署 站 点 ， 包 括 FTP、SCP 和 
DAV ° 


如 下 代码 就 配置 了 一 个 基于 DAV 协 议 的 站 点 部 署 地 址 


; 
project > 


distributionManagement : 
<sit 

< ia >app-site </id> 
<url >dav:h 


v:https://www 
</site> 


juvenxu.com/sites/app < /url > 
< /distributionManagement : 


< /project > 


ERREF, hE Uda Fk, SARA ae SC FFWEBDAV 。 
此 外 ， 为 了 确保 安全 性 ， 服 务 器 的 访问 一 般 都 需要 认证 。 这 个 时 候 就 
需要 配置 settings.xml 文 件 的 server 元 素 


一 扩 与 部 署 构 件 至 Maven 仓 
库 类 似 。 需 要 注意 的 是 ， 要 确保 server 的 id 值 与 site 的 id 值 完全 一 致 


vV > 
id >app-site</id> 
<username > juven < /username > 
<password> * * * * * * < /password > 


< / server > 


需要 提醒 的 是 ， 如 果 在 部 署 的 时 候 遇 到 问题 ， 请 尝试 配置 最 新 的 
maven-site-plugin。 到 本 书 编写 时 为 止 ，2.x 的 最 新 版 本 为 2.1.1，3.x 的 最 
新 版 本 为 3.0-beta-2 。 


如 采 想 要 使 用 FTP 协 议 部 署 站 点 ， 那 么 除了 配置 正确 的 部 署 地 址 和 
认证 信息 外 ， 还 需要 配置 额外 的 扩展 组 件 wagon-ftp， 如 代码 清单 15-13 
所 示 。 


代码 清单 15-13 ”使 用 FTP 协 议 部 署 站 点 


<project > 


<build> 
<plugins > 


<plugin > 
<grt OupI org.apache.maven.pnplugins < /groupId > 
<artifa abies > MAV re me /artifactId> 
sion >2.1.1</version 
</plugin > 


< /plugins > 
<extensions > 
<extension > 
< GroupIQGQ >org. apache. maven. wagon < /groupid > 
cartifactid >wagon-ftp < /artifactId> 


version >1.0-beta- < /version > 
< f/extension > 
< /extensions > 
< /build > 
<distributionManagement > 
<site> 
<id>app-site</id> 
<url >ftp://www. juvenxu. com/site/app < /url > 
cf SLCe > 


< /distributionManagement > 


< /project > 


上 述 代 码 中 最 重要 的 部 分 是 通过 extension 元 素 配置 了 扩展 组 件 
wagon-ftp， 有 了 该 组 件 ，Maven 才 能 正确 识别 FTP 协 议 。 该 代码 中 为 
maven-site-plugin 和 wagon-ftp 都 配置 了 最 新 的 版 本 ， 这 么 做 古 为 了 避免 
之 前 版 本 中 存在 的 一 些 bug 。 


如 采 硕 望 通过 SCP 协 议 部 署 站 点 ， 只 需要 相应 地 配置 
distributionManagement 元 素 即 可 。 如 下 : 


<project > 
<distributionManagement > 


<site> 
<id> ape sh te < </id> 
<url >scp://shell. juvenxu.com/home/juven/maven/site/ < /url > 
sj ce > 


JistributionManagement > 


< /project > 


SJDAVANFIPA A, SCP PGE Ri HED ATU, KEE 
settings.xml 中 配置 认证 信息 的 时 候 ， 就 可 能 需要 passphrase 和 PrivateKey 
JCA e 如 下 : 


<id>app-site< /i 
< passphrase >: >passphrase < /passphrase 
<privateKey >C:/s 


>G: 5 


shkeys/id_rsa < /privateKey > 
< / Server > 


上 述 代 码 中 ，privateKey 表 示 私 钥 的 地 址 ，passphrase 表 示 私 钥 的 口 


a 


o 


Yi abe wht Ribs AENA, HAA TAARE 


让 Maven 部 署 站 点 了 : 


$ mvn clean site-deploy 


site-deploy 是 site 生 命 周 期 的 一 个 阶段 ， 其 对 应 绑 定 了 maven-site- 
plugin 的 deploy 目 标 ， 该 目标 的 工作 就 是 部 署 Maven 站 点 。 


15.8 WE 


本 章 详细 讲述 了 如 何 使 用 Maven 生 成 项 目 站 点 ， 首 先 介绍 了 如 何 
快速 生成 一 个 最 简单 的 站 点 ， 然 后 在 此 基础 上 通过 丰富 项 目 信息 来 丰 
富 站 点 的 内 容 。 用 户 还 能 够 使 用 大 量 现 成 的 插件 来 生成 各 种 站 点 报 
告 ， 包 括 JavaDocs、 源 码 交 叉 引 用 、CheckStyle、PMD、ChangeLog 以 
及 测试 覆盖 率 报告 等 。 


此 外 ，Maven 还 允许 用 户 自 定义 站 点 各 个 部 分 的 外 观 ， 甚 至 更 换 
皮肤 。 如 果 用 户 有 自 定 义 的 内 容 想 放 入 站 点 ， 则 可 以 编写 APT 或 者 
FML 文 档 。 


本 章 还 介绍 了 如 何 配置 POM 来 支持 中 文 的 站 点 。 最 后 ， 用 户 可 以 
使 用 WEBDAV、EFTP 或 者 SCP 协 议 将 站 点 发 布 到 服务 器 。 


16 m2eclipse 


-m2eclipse fal JT 
-TE Maven H 
. 寻 入 Maven 项 目 
-执行 mvn 命 令 
.访问 Maven 仓 库 


-管理 项 目 依赖 


-小结 


由 于 Eclipse 是 非常 流行 的 IDE， 为 了 方便 用 户 ， 日 常 开发 使 用 的 
各 种 工具 都 会 提供 相应 的 Eclipse 插件 。 例 如 ，Eclipse 默 认 就 集成 了 
JUnit 单 元 测试 框架 、CVS 版 本 控制 工具 以 及 Mylyn 任 务 管理 框 染 。 
Eclipse 插件 的 数量 非常 多 ， 读 者 可 以 访问 Eclipse Marketplace LI T fi 
各 种 各 样 的 Eclipse 插件。m2eclipse 就 是 一 个 在 Eclipse 中 集成 Maven 的 


插件 ， 有 了 该 插件 ， 用 户 可 以 方便 地 在 Eclipse 中 执行 Maven 命 令 、 创 
建 Maven 项 目 、 修 改 POM 文 件 等 。 本 章 将 详细 介绍 m2eclipse 的 使 用 。 


[1] 网址 为 : http://marketplace.eclipse.org/。 


16.1 m2eclipsefai Tt 


和 Nexus 一 样 ，m2eclipse 也 是 Sonatype 出 品 的 一 款 开 源 工 具 。 它 基 
于 Eclipse Public License-v.10 开 源 许 可 证 发 布 ， 用 户 可 以 人 免费 下 载 并 使 
用 ， 还 可 以 查看 其 源 代 码 。m2eclipse 的 官方 站 点 地 址 为 


http://m2eclipse.sonatype.org/ ° 


m2eclipse 为 Eclipse 环境 提供 了 全 面 丰 富 的 Maven 集 成 。 它 的 主要 
功能 如 下 : 


.创建 和 导入 Maven 项 目 

.管理 依赖 并 与 Eclipse 的 classpath 集 成 
-自动 下 载 依赖 

自动 解析 依赖 的 sources 与 javadoc 包 
.使 用 Maven Archetype 创 建 项 目 
浏览 与 搜索 远程 Maven 仓 库 

.从 Maven POM 具 体 化 一 个 项 目 


.从 SCM 仓 库 签 出 Maven 项 目 


Asai REN 2 IR Maven H Eclipse 
.集成 Web Tools Projects (WTP) 

.集成 Subclipse 

-集成 Mylyn 

可视化 POM 编 辑 


图形 化 依赖 分 析 


16.2” 狐 建 Maven 项 日 


m2eclipse 的 安装 已 经 在 2.5 字 中 详细 介绍 ， 这 里 不 再 歼 述 。 在 
m2eclipse 中 新 建 一 个 Maven 十 分 人 简单， 在 菜单 栏 中 依次 选择 
File New 一 Other， 这 时 可 以 看 到 图 16-1 所 示 的 向 导 。 


选择 Maven Project 之 后 ， 辣 导 会 提示 用 户 选 择 是 否 跳 过 archetype 而 
创建 一 个 最 简单 的 Maven 项 目 (Create a simple project) 。 这 个 最 简单 
项 目 将 只 包含 最 基本 的 Maven 项 目 目录 结构 ， 读 者 可 以 根据 自己 的 需要 
进行 选择 。 如 果 选 择 使 用 Archetype 创 建 项 目 ， 单 击 Next 按 钮 之 后 ， 向 
导 会 提示 用 户 选 择 Archetype， 如 图 16-2 所 示 。 


y 


Iy 


Select a wizard 
Create a Maven Project 


Wizards: 


|type filter text 


(& General 

& Cvs 

& Java 

© Maven 
EI, Checkout Maven Projects from SCM 
M Maven Module 
k} Maven POM file 


| @ [secre] rh) oa 


图 16-1 新建 Maven 项 目 癌 导 


© New Maven Project 


New Maven project 


Select an Archetype 


Catalog: 


Filter: 


Nexus Indexer 
Group 1 Internal 
Default Local 


org.apaure rene : . — 
org.apache.maven.archetypes maven-archetype-j2ee-simple RELEASE 
org.apache.maven.archetypes maven-archetype-marmalade-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-mojo RELEASE 
org.apache.maven.archetypes maven-archetype-portlet RELEASE 
org.apache.maven,archetypes maven-archetype-profiles RELEASE 


z 


|¥| Show the last version of Archetype only E] Include snapshot archetypes 


» Advanced 


图 16-2 ”选择 创建 项 目的 Archetype 


图 16-2 中 有 4 个 Archetype Catalog 可 供用 户 选 择 ， 包 括 maven- 
archetype-plugin 内 置 的 Internal、 本 地 仓库 的 Default Local、m2eclipse 下 
载 到 仓库 索引 中 包含 的 Nexus Indexer， 以 及 所 有 这 3 个 合并 得 到 的 All 
Catalogs。 如 果 对 Archetype Catalog 不 是 很 清楚 ， 可 以 参考 18.3 广 。 一 般 
来 说 ， 只 需要 选择 Internal， 然 后 再 选择 一 个 Archetype (如 maven- 


archetype-quickstart) ， 最 后 单 击 Next 按 钮 。 


接 下 来 要 做 的 驶 是 输入 项 目 坐 标 Group Id ` Artifact Id ` Version AK 
包 名 。 这 一 个 步骤 与 在 命令 行 中 使 用 Archetype 创 建 项 目 类 似 ， 如 果 
Archetype 有 其 他 可 配置 的 属性 ， 用 户 也 可 以 在 这 里 一 并 配置 ， 如 图 16- 
3 所 示 。 


$ New Maven Project 


New Maven project 


Specify Archetype parameters 


Group Id: comjuvenxu 
Artifact Id: sample 
Version: 0.0,1-SNAPSHOT 


Package: com,juvenu.sample 


Properties available from archetype: 


Name Value 


> Advanced 


图 16-3 ”为 项 目 输入 坐标 和 包 名 


单 击 Finish 按 钮 之 后 ，m2eclipse 就 会 快速 地 在 工作 区 创建 一 个 


Maven 项 目 ， 这 同时 也 是 一 个 Eclipse 项 目 。 


16.3 &SAMavenlii H 


较 之 于 创建 新 的 Maven 项 目 ， 实 际 工作 中 更 常见 的 是 导入 现 有 的 
Maven 项 目 。m2eclipse 文 持 多 种 导入 的 方式 ， 其 中 最 常用 的 是 导入 本 地 
文件 系统 的 Maven 项 目 以 及 导入 SCM 仓 库 中 的 Maven 项 目 。 


单 击 菜单 栏 中 的 File， 然 后 选择 Import 开 始 导 入 项 目 ， 如 图 16-4 所 


从 图 16-4 中 可 以 看 到 在 Maven 类 中 有 4 种 导入 方式 ， 常 用 的 就 是 第 
一 种 和 第 二 种 ， 即 导入 SCM 仓 库 中 的 Maven 项 目 和 导入 本 地 文件 系统 
的 Maven 项 目 。 


图 16-4 中 的 Install or deploy an artifact to a Maven repository 能 让 用 户 
将 任意 的 文件 安装 到 Maven 的 本 地 仓库 。 如 果 该 文件 没有 对 应 的 
POM， 则 需要 为 其 定义 Maven 坐 标 。 


3 import 


Select 


Import Existing Maven Projects 


Select an import source: 
type filter text 


E> General 
> CVS 
> Maven 
LI Check out Maven Projects from SCM 
LJ Existing Maven Projects 
, Install or deploy an artifact to a Maven repository 

三 Materialize Maven Projects 

EE Run/Debug 

区 SVN 

(= Tasks 

E Team 

区 XML 


图 16-4 开始 导入 Maven 项 目 


图 16-4 中 的 Materialize Maven haat 户 导 入 第 三 方 的 Maven 
项 目 ， 用 户 只 需要 提供 一 些 关 键 字 如 nexus-api， 然 后 选择 要 导入 的 项 
目 ，m2eclipse 就 能 基于 索引 找到 其 对 应 的 POM 信 息 。 如 果 该 POM 中 包 
售 了 SCM 信 息 ，m2eclipse 束 能 直接 下 载 该 项 目的 源码 并 导入 到 
m2eclipse 中 。 当 用 到 某 个 第 三 方 类 库 ， 同 时 想 研究 其 源码 的 时 候 ， 这 
一 特性 就 非常 有 用 ， 你 不 再 需要 打开 浏 哎 絮 去 寻找 该 项 目的 信息 ， 简 


单 地 在 m2eclipse 中 操作 几 步 殉 能 完成 第 三 方 项 目的 导入 。 当 然 ， 这 一 
特性 的 前 提 有 是 第 三 方 类 库 提 供 了 正确 的 SCM 信 息 。 大 多 数 开 源 项 目 在 
往 Maven 中 央 仓 库 提 区 构件 的 时 候 都 会 提供 完整 的 信息 ， 但 也 有 例外 ， 
为 了 避免 信息 不 完整 的 项 目 进 入 Maven 中 央 仓 库 ， 最 新 的 规则 已 经 强制 
要 求 提交 者 提供 完备 的 信息 ， 如 SCM、 许 可 证 以 及 源码 包 等 。 这 无 疑 
能 帮助 m2eclipse 表 现 得 更 好 。 


16.3.1 导入 本 地 Maven 项 目 


现在 详细 介绍 一 下 如 何 导 入 本 地 Maven 项 目 。 选 择 图 16-4 中 的 
Existing Maven Projects 项 ， 然 后 在 弹出 的 对 话 框 中 选择 本 地 项 目 所 在 的 
目录， 如 图 16-5 所 示 。 


m2eclipse 能 够 目 动 识别 出 目录 中 所 包含 的 Maven 项 目 ， 如 果 发 现 钙 
多 模块 项 目 ， 则 会 列 出 所 有 的 模块 。 用 户 可 以 根据 自己 的 需要 选择 要 
导入 的 模块 ， 然 后 单 击 Finish 按 钮 。m2eclipse 会 执行 导入 项 目 信息 、 更 
新 下 载 项 目 依赖 ， 以 及 重建 工作 区 等 操作 。 根 据 实际 项 目的 情况 ， 这 
个 过 程 可 能 花费 几 十 秒 到 十 几 分 钟 。 


Maven Projects 
Select Maven projects 


Root Directory; D:\git-juven\maven-book\code\ch-12 
Projects: 


4 |7] /pom.xml - comjuvenxu.mvnbook.accountaccount-aggregator1.0.0-SNAPSHOT:pom 
account-email/pom.xml - com,juvenxu.mynbook.eccounteccount-email;1.0,0-SNAPSHOTijar 
圆 account-persist/pom.xml - com,juvenxu.mvnbook accountaccount-persist:1.0.0-SNAPSHOT;jal 
W] account-parent/pom.xml - com.juvenxu.mvnbook.account:account-parent:1.0.0-SNAPSHOT:pc 
加 account-captcha/pom.xml - comjuvenxu.mynbook.account:account-captcha:1.0.0-SNAPSHOT:| — 
闻 account-service/pom.xm| - com,juvenxu.mynbook. account:account-service:1.0.0-SNAPSHOT;ja 


贺 account-web/pom.xml - comjuvenxu.mynbook.account:account-web:1.0.0-SNAPSHOT:wer 


EO  L 
[E] Add project(s) to working set 


Working set: | ~|| More... 


» Advanced 


图 16-5 AIM Maven H 


16.3.2 ”从 SCM 仓 库 导 入 Maven 项 目 


通常 我 们 的 项 目 源 代码 都 存储 在 SCM 仓 库 中 ， 例 如 Subversion 仓 
库 ， 读 者 当然 可 以 使 用 Subversion 命 令 将 项 目 源码 等 出 到 本 地 ， 然 后 再 
导入 到 m2eclipse 中 。 但 m2eclipse 文 持 用 户 直 接 从 SCM 仓 库 中 导入 


Maven 项 目 。 


要 从 SCM 守 入 Maven 项 目 ， 首 先 需 要 确保 安装 了 集成 SCM 的 
Eclipse 插 件 ， 如 Subclipse， 还 需要 m2eclipse 的 附属 组 件 Maven SCM 
Integration 以 及 对 应 的 SCM handler， 如 集成 Subclipse 的 Maven SCM 


handler for Subclipse ° 


WRAAE EMR, WEY tE 116-44 Check out 
Maven Projects from SCM， 在 单 击 Next 按 钮 之 后 ， 选 择 SCM 类 型 并 输入 
SCM 地 址 ， 如 图 16-6 所 示 。 


© checkout as Maven project from SCM 


Target Location 


Select target location and revision 


SCM URL: |svn -| http://svn.apache.org/repos/asf/maven/archetype v ‘Browse... 
[V Check out Head Revision 


Select... 


[V] Check out All projects 
» Advanced 


< Back Next > | | Finish Cancel 


图 16-6 ”从 SCM 仓 库 导 入 Maven 项 目 


单 击 Next 按 钮 之 后 用 户 可 以 选择 项 目 寻 入 的 本 地 位 置 ， 然 后 单 击 
Finish 按 钮 ，m2eclipse 就 会 在 后 台 使 用 SCM 工 具 签 出 项 目 并 执行 Maven 
构建 。 用 户 可 以 单 击 Eclipse 右 下 角 的 状态 栏 查看 后 台 进 程 的 状态 ， 如 
图 16-7 所 示 。 


Checking out Maven projects 


Checking out Maven projects: (17%) =- © 


图 16-7 m2ecdlipse 在 后 台 签 出 项 目 


同样 地 ， 根 据 项 目 大 小 以 及 网 络 的 健康 状况 ， 这 个 过 程 可 能 花费 
几 十 秒 到 几 十 分 钟 不 等 。 


16.3.3 ”m2ecdlipse 中 Maven 项 目的 结构 


一 个 典型 的 Maven 项 目 在 m2eclipse 中 的 结构 如 图 16-8 所 示 。 


lackage Explorer £3 fs Hierarchy Ju JUnit| 
“> account-persist 
4 ES src/main/java 
b —B comjuvenxu.mvnbook.account.persist 
4 CS src/main/resources 
四 account-persist.xml 
4 CS src/test/java 
b Æ@ comjuvenxu.mvnbook.account.persist 
4 CE src/test/resources 
B account-service.properties 
mA JRE System Library [/2SE-1.5] 
4 Š Maven Dependencies 
> ġa dom4j-1.6.1 jar - D:\java\repository\dom4j\dom4]\1L.6.1 
> dw xml-apis-1.0.b2jar - D:\java\repository\xml-apis\xml-apis\1.0.b2 
> ġa spring-core-2.5.6jar - D:\java\repository\org\springframework\spring-core\2.5.6 
> fi commons-logging-1.1.1jar - D:\java\repository\commons-logging\commons-logging\1.1.1 
> ġa spring-beans-2.5.6.jar - D:\java\repository\org\springframework\spring-beans\2.5.6 


> ġa spring-context-2.5.6jar - D:\java\repository\org\springframework\spring-context\2.5.6 
b (@ aopalliance-LOjar - D:\java\repository\aopalliance\aopalliance\1.0 


> da junit-4.7jar - D:\java\repository\junit\junit\4.7 


& src 
© target 
‘ul pom.xml 


4 | 


图 16-8 ”m2edlipse 中 的 Maven 项 目的 结构 


Maven 项 目的 主 代码 目录 src/main/java/、 主 资源 目 杂 
src/main/resources/、 测试 代码 目录 src/test/java/ 和 测试 资源 目录 
src/test/resources/ 都 被 自动 转换 成 了 Eclipse 中 的 源码 文件 夹 (Source 


Folder) 。Maven 的 依赖 则 通过 Eclipse 库 (Libraries) 的 方式 引入 ， 所 
有 Maven 依 赖 都 在 一 个 名 为 Maven Dependencies 的 Eclipse 库 中 。 需 要 注 
意 的 是 ， 这 些 依赖 文件 并 没有 被 复制 到 Eclipse 工 作 区 ， 它 们 只 是 对 
Maven 本 地 仓库 的 引用 。 所 有 的 源码 文件 夹 和 Maven 依 赖 都 在 Eclipse 项 
目的 构建 路 径 (Build Path) 中 。 当 然 ， 用户 还 可 以 直接 访问 项 目 根 目 
好 下 的 pom.xml 文 件 。 此 外 ， 代 码 目 录 和 资源 日 录 之 外 的 其 他 日 好不 会 
被 转换 成 Eclipse 的 源码 文件 夹 ， 它 们 不 会 被 加 入 到 构建 路 径 中 ， 但 用 
户 还 是 可 以 在 Eclipse 中 访问 它们 。 


注意 : 如 果 用 户 更 改 了 POM 内 容 且 导致 项 目 结构 发 生变 化 ， 例 如 
添加 了 一 个 额外 的 资源 目录 ，m2edlipse 可 能 无 法 自动 识别 。 这 时 用 户 
需要 主动 让 m2eclipse 更 新 项 目 结构 : 在 项 目 或 者 pom.xml 上 单 击 鼠标 右 
键 ， 选 择 Maven， 再 选择 Update Project Configuration ° 


16.4 执行 mvn 命 令 


到 目前 为 止 ， 大 家 已 经 了 解 了 如 何在 m2eclipse 中 创建 Maven 项 目 和 
导入 Maven 项 目 ， 下 一 步 要 做 的 就 是 构建 这 些 项 目 ， 或 者 说 在 这 些 项 目 
中 执行 mv 命令。 当然 ， 大 家 还 是 可 以 在 命令 行 的 对 应 目录 下 执行 mvn 
命令 ， 不 过 这 里 要 讲 的 是 如 何在 m2eclipse 中 直接 执行 mvn 命 令 。 


要 在 m2eclipse 中 执行 mvn 命 令 ， 首 先 要 做 的 是 打开 m2eclipse 的 
Maven 控 制 台 。 一 般 来 说 ，Eclipse 窗 口 的 下 方 会 有 一 个 终端 
(Console) 视图 ， 打 开 该 视图 后 ， 可 以 在 视图 的 右上 角 选 择 打开 
Maven 终 疹 ， 如 图 16-9 所 示 。 


K Declarati | 3 Call Hier | 4° Search | Progres | £ History Ed Console £2 
pst in D:/git-juven/maven-book/code/ch-: KH = de 
1 Java Stack Trace Console 
2 New Console View 
3 SVN 控制 台 
=) 4CVS 


m2 5 Maven Console 


图 16-9 打开 Maven 终 端 


Maven 终 端 视 图 中 会 显示 m2eclipse 中 所 有 mvn 命 令 的 输出 。 现 在 可 
以 在 Maven 项 目 中 执行 mvn 命 令 。 直 接 在 项 目 上 或 者 pom.xml 上 单 击 鼠 
标 右键 ， 选 择 Run As 选项 ， 就 能 看 到 如 图 16-10 所 示 的 荣 单 。 


Paste Ctrl+V 
Delete Delete 


1g 


1 Java Applet Alt+ Shift+X, A 
2 Java Application Alt+Shift+X, J 
3 JUnit Test Alt+Shift+xX, T 
4 Maven assembly:assembly 

5 Maven build Alt+Shift+X, M 
6 Maven build... 

7 Maven clean 


` 


Remove fron intext tri+ Alt+Shift+ n 
Build Path > 
Source Alt+Shift+s » 
Refactor Alt+Shift+T » 


RRB 


Import... 


4 Export... 
P 8 Maven generate-sources 


Refresh 
Close Project 


9 Maven install 
Maven package 


Close Unrelated Projects 


Maven source:jar 


aaa RBG 


Assign Working Sets... Maven test 


Run As Run Configurations... 
Debug As 


图 16-10 “执行 Maven 构 建 命令 


在 图 16-10 中 可 以 看 到 ， 染 单 预 置 了 很 多 构建 命令 ， 包 括 clean、 
test、package 以 及 install 等 ， 直 接 单 击 就 能 让 m2eclipse 执 行 相应 的 
Maven 构 建 。 


如 果 想 要 执行 的 mvn 命 令 并 没有 被 预 置 在 这 个 菜单 中 该 怎么 办 呢 ? 
这 时 可 以 选择 图 16-10 中 的 Maven build 项 来 自 定 义 mvn 命 令 。 图 16-11 显 
示 的 是 单 击 Maven Build... 项 后 显示 的 自 定义 mvn 命 令 配 置 对 话 框 。 


Name: account-persist clean install 


[E] Main» ma JRE | we Refresh) I Environment) Œ Common | 
Base directory: 


D:/git-juven/maven-book/code/ch-12/account-aggregator/account-persist 


| Browse Workspace... | Browse File System... | | Variables... | 


Goals: clean install | Select.. | 
Profiles: 


"| Offline 7) Update Snapshots 
~ |Debug Output [Skip Tests | |Non-recursive 
了 Resolve Workspace artifacts 


Parameter Name Value 


Maven Runtime: ‘External D:\bin\apache-maven-3.0-beta-1 (3.0-beta-1) 


图 16-11 ” 自 定 义 mvn 命 令 


图 16-11 为 该 配置 提供 了 Maven 目 标 clean install， 还 定义 了 一 个 
account-persist clean install 的 名 称 以 方便 日 后 重用 。 读 者 可 以 看 到 该 配 
置 页 面 能 让 用 户 自 定义 很 多 内 容 ， 例 如 是 否 更 新 Snapshots、 是 否 跳 过 
测试 、 是 否 开 启 Debug 输 出 ， 还 包括 添加 额外 的 运行 参数 ， 等 等 。 配 置 
成 后 ， 单 击 Run 按 钮 就 能 执行 该 mvn 命 令 了 了 。 读 者 可 以 在 Maven 终 并 


看 运行 输出 。 


im 让 


使 用 上 述 的 方法 可 以 和 目 定 义 任意 多 的 mvn 命 令 ， 而 且 这 些 配 置 都 是 
可 以 被 重用 的 。 要 再 次 运行 目 定义 的 mvn 命 令 ， 单 击 图 16-10 中 的 
Maven build (注意 没有 省 略 号 ) ， 然 后 就 能 看 到 如 图 16-12 所 示 的 对 话 
HE o 


= Select Configuration 


Select a launch configuration to run: 


m2 account-persist clean compile : clean compile 


m2 account-persist clean install : clean install 
m2 account-persist clean test : clean test 


图 16-12 ”重用 目 定 义 mvn 命 令 


如 图 16-12 所 示 ， 读 者 可 以 选择 并 直接 运行 之 前 配置 过 的 目 定义 
mvn 命 令 。 需 要 注意 的 是 ， 如 果 只 配置 了 一 个 自 定 义 mvn 命 令 


m2eclipse 会 跳 过 该 选择 框 并 直接 运行 ， 如 有 果 还 没有 配置 任何 目 定 义 的 


> 


mvn 命 令 ，m2eclipse 则 会 提供 配置 对 话 框 让 读者 定义 (第 一 次 ) mvn 命 


& o 


16.5 “访问 Maven 仓 库 


有 了 m2eclipse， 用 户 可 以 直接 在 Eclipse 中 浏览 本 地 和 远程 的 
Maven 人 仓库， 并 且 能 够 基于 这 些 仓库 的 索引 进行 构件 搜索 和 Java 类 搜 
索 。 这 样 就 免 去 了 离开 Eclipse 访问 本 地 文件 系统 或 者 浏览 釉 的 麻烦 ， 
提高 了 日 常 开发 的 效率 。 


16.5.1 Maven C JÆ] 


m2eclipsete te Y Maven C ÆA], BELEH A AEA it ANH ME 
CENE, PERNE PAA A BOTS ° ZF Maven b #4 
图 ， 依 次 选择 Eclipse 琳 单 栏 中 的 Windows、Show View ` Other, 
Eclipse 会 弹出 一 个 对 话 框 让 用 户 选 择 要 打开 的 视图 。 选 择 Maven 类 下 的 


Maven Repositories， 如 图 16-13 所 示 。 


S Show View 


type filter text 


(= General 
Ant 
> CVS 
=, Debug 
Help 
Java 
Java Browsing 
Maven 
局 Maven Repositories 
= SVN 
Tasks 
[SE Team 


Use F2 to display the description for a selected view. 


416-13 ”打开 Maven 仓 库 视 图 


这 时 可 以 在 Edipse 窗 口 下 方 看 到 Maven 仓 库 视图 ， 这 个 视图 中 包 
了 3 类 Maven 人 仓库， 分 别 为 本 地 仓库 、 全 局 仓库 以 及 项 目 仓 库 ， 如 图 16- 


14 所 示 。 


其 中 本 地 仓库 包含 了 Maven 的 本 地 仓库 以 及 当前 Eclipse 工作 区 的 项 
A; 全 局 仓库 默认 是 Maven 中 央 人 仓库， 但 是 如 果 在 settings.xml 中 设置 了 
镜像 ， 全 局 仓库 就 会 目 动 变更 为 镜像 仓库 。 最 后 ， 如 果 当 前 Maven 项 日 
的 pom.xml 中 配置 了 其 他 仓库 ， 它 们 就 会 被 目 动 加 入 到 项 目 仓 库 这 一 类 
中 。 这 些 仓库 的 信息 来 源 于 用 户 的 settings.xml 文 件 和 工作 区 中 Maven 项 
目的 pom.xml 文 件 。 


(8: Problems|" Search |G Progress | = History| GJ Console | 局 Maven Repositories 22 


A Local Repositories 
=) Local repository (D:\java\repository) 
=) Workspace projects 
= Global Repositories 
E central (http://repol.maven.org/maven2) 


|=} Project Repositories 


图 16-14 ”Maven 仓 库 视 图 


用 户 可 以 以 树 形 结构 快速 浏览 仓库 的 内 容 ， 双 击 叶 子 节点 ， 打 开 
构件 对 应 的 POM 文 件 ， 如 图 16-15 所 示 。 


4 |& Local Repositories 
4 |= Local repository (D:\java\repository) 
& cglib 
> com 
4 (= google 
& code 
4 E protobuf 
j protobuf-java - pom 


四 protobuf-java ; 2.0.3 


= commons-discovery 
= javax 
= jmock 
= junit 
|) junit - pom 


org 


图 16-15 Xii Maven C ENZ 


大 家 可 能 已 经 猜 到 ，m2eclipse 其 实 不 会 真正 地 去 存储 所 有 仓库 的 
内 容 ， 那 样 需要 消耗 大 量 的 磁盘 及 网 络 带宽 。 因 此 与 Nexus 一 样 ， 
m2eclipse 使 用 nexus-indexer 索 引 仓库 内 容 的 信息 。 以 全 局 仓库 central 为 
例 ， 用 户 在 首次 使 用 m2eclipse 的 仓库 浏览 及 搜索 功能 之 前 ， 需 要 构建 
该 仓库 的 索引 ， 在 如 图 16-16 所 示 的 仓库 上 右 击 。 


RFE Se H Rebuild IndexiFm2eclipse 重 新 下 载 完 整 的 远程 索引 
由 于 当前 仓库 是 central， 索 引文 件 较 大 ， 因 此 重建 该 索引 会 消耗 比较 长 
的 时 间 。Update Index 则 i 上 m2eclipse 以 增 量 的 方式 下 载 索 引文 件 。 如 果 


是 本 地 仓库 ，Update Index 将 无 法 使 用 ， 而 Rebuild Index 的 效果 是 重新 
遍历 本 地 仓库 的 文件 建立 索引 。 


图 16-16 中 的 菜单 还 有 几 个 选项 ，Disable Index Detailsiim2eclipse 
关闭 该 仓库 的 索引 ， 从 而 用 户 将 无 法 浏览 该 仓库 的 内 容 ， 或 者 对 其 进 
行 搜索 。Minimum Index Enabled 表 示 只 对 仓库 内 容 的 坐标 进行 索引 ， 
而 Enable Full Index 不 仅 索引 仓库 内 容 的 坐标 ， 还 索引 这 些 文件 所 包 
的 Java 类 信息 ， 从 而 能 够 支持 用 户 搜 索 仓库 中 的 Java 类 。 


4 (A Global Repositories 
j=) central (http: 
= Project Repositt ates 
Copy URL 
Materialize Pro 


f=] apache nap 
m sonatype 
局 Custom repii <= Update Index 


A Rebuild Index 


#5 Disable Index Details 


ES Minimum Index Enabled 
%5 Enable Full Index 


=| Collapse All 


10 Back 


> Go Into 


图 16-16 构建 仓库 索引 


16.5.2 ”搜索 构件 和 Java 类 


有 了 仓库 索引 之 后 ， 用 户 就 可 以 通过 关键 字 搜 索 Maven 构 件 了 。 单 
击 Edlipse 菜 单 栏 中 的 Navigate， 再 选择 Open Maven POM 选 项 ， 就 能 得 
到 构件 搜索 框 。 输 入 关键 字 后 就 能 得 到 一 个 结果 列表 ， 还 可 以 扩 击 列 
表 项 进一步 展开 以 查看 版 本 信息 ， 如 图 16-17 所 示 。 双 击 某 个 具体 版 本 
的 构件 能 让 m2eclipse 直 接 打 开 对 应 的 POM 文 件 。 


$ Search Maven POM 


Enter groupld, artifactid or shai prefix or pattern (*): 
ehcache 

Search Results: 

口 com.octo.captcha jcaptcha-extension-ehcache-store 
B ehcache ehcache 

B jpox jpox-ehcache 

A net.sfiehcache ehcache 


a 0 netsfiehcache ehcache-core 
四) 2.1.0 - ehcache-core-2.1.0,jar - 604K - Wed May 19 22:06:22 CST 2010 [http://repol.maven.org/maven2] 


四) 2,1,0-beta - ehcache-core-2,1.0-beta,jar - 591K - Tue Apr 20 21:35:46 CST 2010 [http://repol.maven 
i, 2.0.1 - ehcache-core-2.0.1jar - 488K - Thu Apr 08 08:06:26 CST 2010 [http://repo1.maven.org/mave! 
号 2.0.0 - ehcache- ~core-2.0.0,jar - 484K - Fri Mar 05 03:44:06 CST 2010 (http: //repol.maven.org/maven ~ 


a tH, + 


Elinclude javadocs ”加 Include Sources [Flinclude Tests 


ehcache-core-2.1.0.jar 618343 Wed May 19 22:06:22 CST 2010 


@ [ox |[ Canc | 


图 16-17 搜索 Maven 构 件 


如 果 为 仓库 开启 了 Enable Full Index 选 项 ， 也 就 是 说 索引 中 包含 了 
Java 类 型 信息 ， 则 就 可 以 通过 Java 类 名 的 关键 字 寻 找 构件 。 单 击 Eclipse 
菜单 栏 中 的 Navigate， 再 选择 Open Type from Maven， 就 能 得 到 类 搜索 
框 。 输 入 关键 字 后 就 能 得 到 图 16-18 所 示 的 搜索 结果 。 同 样 ， 用 户 可 以 
单 击 列表 项 展开 其 版 本 ， 还 可 以 双击 具体 版 本 打开 其 POM 。 


© Search class in Maven repositories 


s x) 
Enter groupld, artifactid or shal prefix or pattern (*): 
ehcache 


Search Results: 


EhCacheProvider org.hibernate.cache org.ow2.easybeans.osgi easybeans-core 
EhCacheRegionFactory net.sfehcache.hibernate netsfiehcache ehcache-core 
EhCacheRegionFactory net.sf.ehcache,hibernate org.ow2.orchestra orchestra-core 
EhCacheXAResourceHolder net.sf.ehcache.transaction.manager.btm netsf.ehcache ehcache-core 
EhCachexAResourceProducer net.sf.ehcache.transaction.manager.btm net.sf.ehcache ehcache-core| 
Ehcache net.sf.ehcache netsf.ehcache ehcache 

Ehcache net.sfehcache netsfehcache ehcache-core 

[A 2.1.0 - ehcache-core-2,1.0,jar - 604K - Wed May 19 22:06:22 CST 2010 [http://repol.maven.org/may 
[A 2.1.0-beta - ehcache-core-2.1.0-beta.jar - 591K - Tue Apr 20 21:35:46 CST 2010 [http://repol.maven 
区 2.0.1 - ehcache-core-2.0.1,jar - 488K - Thu Apr 08 08:06:26 CST 2010 [http://repol.maven.org/mavei 


fh INN -ahrarho renra. INN iar . AQAW ~ Eri Mar NS NDAA-NK CCT IMIN httn://rannt maven nra imawan 
4 pi b 


B B B B B OBE 


> 


orchestra-core-4,4,2,bundle 6867992 Thu May 20 15:48:52 CST 2010 


D) OK | | Cancel 


图 16-18 ”搜索 Java 类 


不 用 离开 Eclipse， 用 户 就 能 随时 搜索 想 要 使 用 的 类 库 以 及 Java 类 ， 
m2eclipse 仅 仅 要 求 用 户 提 供 一 些 必要 的 关键 字 ， 这 无 疑 是 非常 方便 
Ay ° 


16.6 ”管理 项 目 依 赖 


添加 Maven 依 赖 的 传统 做 法 是 先 搜索 得 到 依赖 的 坐标 ， 然 后 配置 
项 目的 pom.xml 文 件 ， 加 入 dependency 元 素 。 当 然 ， 在 m2eclipse 中 也 可 
以 这 样 做 ， 不 过 m2eclipse 提 供 了 更 方便 的 添加 依赖 的 方法 ， 用 户 直 接 
根据 关键 字 搜 索 依 赖 并 从 结果 中 选择 即 可 。 此 外 ，m2eclipse 还 提供 了 
丰富 的 可 视 化 界面 帮助 用 户 分 析 项 目 中 的 各 种 依赖 以 及 它们 之 间 的 天 
系 。 


16.6.1 添加 依赖 


在 m2eclipse 中 有 多 种 添加 依赖 的 方法 ， 直 接 编 辑 pom.xml 走 一 种 ， 
不 过 这 里 要 讲 的 是 另外 两 种 更 方便 的 做 法 。 


首先 用 户 可 以 在 项 目 上 或 者 pom.xml 上 右 击 ， 然 后 选择 Maven， 再 
选择 Add Dependency 添 加 依赖 ， 如 图 16-19 所 示 。 


在 弹出 的 对 话 框 中 ， 用 户 只 需要 输入 必要 的 关键 子 ， 然 后 选择 要 
添加 的 依赖 及 有 版 本 ， 并 且 设 定 正确 的 依赖 范围 ， 单 击 OK 按 钮 之 后 ， 依 
PT H SDA Z!pom.xml F ° Al16-20Ar RAD asd T 
javax.servlet: servlet-api: 2.5 这 样 一 个 依赖 ， 并 且 在 图 的 下 方 选择 了 
provided 这 样 一 个 依赖 范围 。 


Copy Qualified Name 
Paste 
Delete 


Remove from Context 
Build Path 

Source 

Refactor 


Import... 
Export... 


Refresh 

Close Project 

Close Unrelated Projects 
Assign Working Sets... 


Run As 
Debug As 
Validate 
Maven 
Team 


Ctrl+V 
Delete 


Ctri+Alt+Shift+Down 
» 
Alt+Shift+S » 
Alt+Shift+T » 


Add Dependency 
Add Plugin 


New Maven Module Project 


Update Dependencies 
Update Snapshots 

Update Project Configuration 
Download JavaDoc 
Download Sources 


Open POM 

Open Project Page 

Open Issue Tracker 

Open Source Control 

Open Continuous Integration 


Disable Workspace Resolution 


Disable Dependency Management 


调 Report Issue... 


图 16-19 ”在 项 目 上 添加 依赖 


@ Add Dependency 


Enter groupid, artifactid or shal prefix or pattern (*): 
serviet-api 


Search Results: 


>) javax.servlet serviet-api a | 
i, 2.5 - serviet-api-2.S.jar - 103K - Mon Jul 17 19:09:57 CST 2006 [http://repo1.maven.org/maven2] 
2.4-20040521 - serviet-api-2.4-20040521,Jjar - 96K - Mon Aug 01 17:47:50 CST 2005 [http://repol.me a 
2.4.public_draft - serviet-api-2.4.public_draftjar - 95K - Mon Aug 01 17:53:48 CST 2005 [http://repo] _ 
m 2.4 - serviet-api-2.4,jar - 95K - Mon Aug 01 17:53:27 CST 2005 [http://repol.maven.org/maven2] 
= 2.3 - serviet-api-2.3.jar - 76K - Sat Aug 13 08:02:58 CST 2005 [http://repol.maven.org/maven2] 
i, 2,2 - serviet-api-2.2,jar - 40K - Sat Aug 13 08:02:58 CST 2005 [http://repol.maven.org/maven2] 

D jetty serviet-api 

O org.apache.tomcat servlet-api 

+ | ni 


癌 include Javadocs 辣 Include Sources |F]include Tests 


servlet-api-2.5.jar 105112 Mon Jul 17 19:09:57 CST 2006 


© 


116-20 ”为 项 目 添加 servlet-api 依 赖 


第 二 种 快速 添加 依赖 的 方式 是 使 用 m2eclipse 的 POM 编 辑 器 。 默 认 
情况 下 ， 用 户 双击 项 目的 pom.xml 就 能 打开 POM 编 辑 器 。POM 编 译 器 
下 方 有 很 多 选项 卡 ， 包 括 概览 、 依 赖 、 揪 件 、 报 告 、 依 赖 层 次 、 依 赖 
A] ` Effective POM 等 。 其 中 ， 依 赖 (Dependencies) 一 项 可 以 用 来 添 
加 、 删 除 和 编辑 依赖 ， 如 图 16-21 所 示 。 


[m app/pom.xml. 3 
Dependencies Search: 
Dependencies 加 | = Dependency Details 
Group ld* junit 
Artifact id:* junit 
Version: 3.8.1 
Classifier: 
Type: 
Scope: test 
System Path: 
Dependency Management 四 | $ | Optional 


| Add... Exclusions 


| Create... | 


Overview Dependencies | Plugins Reporting) Dependency Hierarchy Dependency Graph) Effective POM | pom.xml 


图 16-21 POM4m# as PA KR I 
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对 话 框 。 此 外 ， 从 图 中 还 可 以 看 到 ， 用 户 可 以 得 看 依赖 的 细节 并 对 其 
进行 编辑 。 


添加 项 目 依 赖 之 后 ， 如 果 m2eclipse 没 有 自动 将 依赖 更 新 至 项 目的 
构建 路 径 ， 用 户 可 以 强制 要 求 m2eclipse 更 新 ， 方 法 是 在 项 目 或 者 
pom.xml 上 右 击 ， 选 择 Maven， 再 选择 Update Dependencies ° 


16.6.2 分 析 依 赖 


5.9.3 节 介绍 了 如 何 使 用 maven-dependency-plugin 分 析 并 优化 项 目的 
依赖 ，Maven 用 户 可 以 在 命令 行 以 树 状 的 形式 查看 项 目的 依赖 以 及 它们 
之 则 的 关系 。 有 了 m2edlipse， 这 种 可 视 化 的 分 析 将 更 为 清晰 和 直观 。 


开启 POM 编 辑 器 中 的 依赖 层次 项 (Dependency Hierarchy) ， 就 能 
看 到 图 16-22 所 示 的 依赖 层次 图 。 


图 16-22 中 左边 列表 显示 了 项 目的 树 形 依赖 层次 ， 右 边 列 表 则 是 所 
有 Maven 最 终 解 析 得 到 的 依赖 。 默 认 情 况 下 ， 两 个 列表 都 会 显示 依赖 的 
artifact、version 以 及 scope。 要 但 看 依赖 的 groupId， 可 以 单 击 列表 上 方 
右 起 第 二 个 按钮 


Show GroupId ° 


有 了 这 样 一 个 依赖 层次 图 ， 用 户 殊 能 很 清晰 地 看 到 所 有 依赖 是 如 
何 进 入 到 项 目 中 来 的 ， 可 能 这 古 个 直接 依赖 ， 那 么 在 左边 的 它 束 是 个 
顶层 市 态 ， 可 能 这 是 个 传递 性 依赖 ， 那 么 这 个 树 形 层 次 下 能 够 告诉 用 
户 传递 路 径 是 什么 。 如 果 这 个 依赖 是 同一 Maven 项 目的 另外 一 个 模块 ， 
那么 它 的 图 标 将 与 其 他 依赖 不 同 ， 而 是 一 个 文件 夹 的 样子 。 如 果 用 户 
单 击 右边 已 解析 依赖 列表 中 的 任意 一 项 ， 左 边 束 会 目 动 更 新 为 该 依赖 
的 传递 路 人 径 ， 如 图 16-23 所 示 。 


Dependency Hierarchy [test] 


Dependency Hierarchy 5 mE 
l 
4 § comicegreen : greenmall : 1.3-1b [test] ‘ount-captcha : 1.0.0-SNAPSHOT [compile] 

0 javax.mail : mail : 1.4.1 (conflicted 1.4) [compile] Č account-email : 1.0.0-SNAPSHOT [compile] 
O org,slfa] : slf4j-api : 1.3.1 [test] Æ account-persist : 1.0.0-SNAPSHOT [compile] 

D activation : 1.1 [compile] 

© aopalliance : 1.0 [compile] 

B commons-logging : 1.1.1 {compile} 

© dom4j : 1.6.1 [compile] 

6 greenmail : 1.3.1b [test] 


b  comjuvenxu.mvnbook.account ; account-email ; 1.0.0-SNA 
4 |S} comjuvenxu.mvnbook.account : account-persist : 1.0.0-SN 
4 0 dom4j: dom4j : 1.6.1 [compile] 
O xml-apis : xml-apis : 1,0.b2 [compile] 
= o an : spring-beans : 2.5.6 as O junit : 4.7 [test] 
| org.springframework : spring-context : 2.5.6 [compile] : 
© org.springframework : spring-core : 2.5.6 [compile] a an = toompilel 
SRR AY Tae 百 sigj-apl rigs [test] 
© spring-beans : 2.5.6 [compile] 
© spring-context ; 2.5.6 [compile] 
D spring-context-support ; 2.5.6 [compile] 
© spring-core : 2.5.6 [compile] 
Bxml-apis : 1.0.b2 [compile] 


i S 
Overview | Dependencies | Plugins | Reporting | Dependency Hierarchy | Dependency Graph Effective POM | pom.xm| | 


图 16-22 ”依赖 层次 列表 


Dependency Hierarchy [test] Search: 


Dependency Hierarchy =p: | (TE) wo 2 Resolved Dependencies (E) wo 部 


i F 


4 [BE account-email : 1.0.0-SNAPSHOT [compile] | | account-captcha : 1.0.0-SNAPSHOT [compile] 
4 © mail: 1.4.1 [compile] i account-email : 1.0.0-SNAPSHOT [compile] 
D activation : 1.1 [compile] i account-persist ; 1.0.0-SNAPSHOT [compile] 
Exclude Maven Artifact... 5 activation : 1.1 [compile] 
Open JavaDoc J aopalliance : 1.0 [compile] 
W Open Project Page [i commons-logging : 1.1.1 [compile] 
Open POM 0 -E 1.6.1 EN 


enm all 


| junit : 4.7 [test] 
J kaptcha : 2.3 - jdk15 [compile] 
) mail : 1.4.1 [compile] 
器 slf4j-api : 1.3.1 [test] 
J spring-beans : 2.5.6 [compile] 
_) spring-context ; 2.5.6 [compile] 
了] spring-context-support : 2.5.6 [compile] 
© spring-core : 2.5.6 [compile] 
口 xml-apis; 1.0.b2 [compile] 


4 Mm p 
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图 16-23 ”查看 已 解析 依赖 的 传递 路 径 


从 图 16-23 中 我 们 知道 ，activation 这 样 一 个 依赖 是 通过 account- 
email 依 赖 的 mail 依 赖 引 入 的 。 


此 外 ， 从 图 16-23 中 还 能 看 到 ， 在 任何 一 个 依赖 上 右 击 ， 可 以 执行 


打开 依赖 的 POM 和 排除 依赖 等 操作 。 尤 其 是 排除 依赖 这 一 操作 ， 比 编 
辑 POM 更 加 直观 和 方便 。 


除了 依赖 层次 列表 ，POM 编 辑 此 还 提供 了 一 个 更 为 图 形 化 、 更 为 
直观 的 依赖 图 ， 如 图 16-24 所 示 。 


| 

í 
Yi 
| 


在 这 个 依赖 图 中 ， 每 个 依赖 都 是 一 个 圆 角 矩形 ， 用 户 可 以 随意 拖 
动 每 个 依赖 ， 被 选择 依赖 与 其 他 依赖 的 连接 线 会 补 标 亮 。 用 户 也 可 以 
在 依赖 上 右 击 ， 选 择 显示 groupId， 以 及 执行 打开 POM 和 排除 依赖 等 操 
{F ° 


api | 


2 13, 


spring-context-support 
b ico pile] 


= Ak rat, LS 
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图 16-24 ”依赖 图 


16.7 其 他 实用 功能 


到 目前 为 止 ， 本 章 介 绍 了 m2eclipse 最 主要 的 几 个 功能 ， 包 括 新 建 
项 目 、 导 入 项 目 、 执 行 mvn 命 令 、 访 问 Maven 仓 库 和 管理 项 目 依赖 。 
m2eclipse 还 有 很 多 珊 碎 的 功能 ， 由 于 其 中 有 一 些 在 实际 中 很 少 用 到 ， 
笔者 不 计划 逐一 详细 介绍 。 本 章 剩 余 的 内 容 讲述 儿 个 m2eclipse 非 闻 实 
用 的 小 特性 。 


16.7.1 POM 编 辑 的 代码 提示 


m2eclipse 的 POM 编 辑 妖 能 让 用 户 以 表单 的 形式 编辑 pom.xml 文 件 ， 
但 很 多 时 候 这 总 没有 直接 编辑 XML 文件 来 得 直接 。 有 了 m2eclipse， 用 
户 在 编辑 pom.xml 的 时 候 就 能 得 到 即时 的 代码 提示 帮助 ， 如 图 16-25 所 


修 ° 


d>${project.groupiId}</groupid> 
tifactid>account—email</artifactid 
sion>${project.version} 


Element : scope 

4.0.0 

The scope of the dependency - compile, runtime, test, system, 

4 | <> exclusions and provided, Used to calculate the various classpaths used for 
<> groupid compilation, testing, and so on. It also assists in determining 
which artifacts to include in a distribution of this project. For 
more information, see the dependency mechanism. 


< SSH | <> artifactid 
<> classifier 


`H | <> optional 
“J| <>scope 
<> systemPath Data Type : string 
<>type 
is <>version 


>com. icegreen</qgroupid> 
d>greenmail</artifactid 


on: Stor eenmail.version} 


416-25 ” POM 编辑 的 代码 提示 


在 图 16-25 中 可 以 看 到 ， 当 用 户 在 <dependency> 元 素 下 输入 左 尖 括 

号 想 要 添加 一 个 子 元 素 的 时 候 ， 会 得 到 可 用 元 素 的 列表 (用 户 也 可 以 

使 用 Alt+/ 主 动 调 出 代码 提示 ) 。 在 该 例 中 ，<dependency> 下 可 用 的 子 
元 素 有 artifactId、classifier、exclusions 以 及 scope 等 。 使 用 键盘 的 上 下 键 


可 以 选择 查看 某 个 元 素 ， 列 表 右 边 就 会 显示 出 该 元 素 的 解释 。 该 例 中 
右边 显示 了 scope 元 素 的 解释 。 选 择 想 要 输入 的 元 素 后 按 Enter 键 ， 
m2eclipse 束 会 自动 填 上 元 素 标 签 ， 用 户 只 需要 输入 元 素 的 值 即 可 。 对 
于 不 熟悉 POM 结 构 的 用 户 来 说 ， 这 种 代码 提示 帮助 他 们 人 免 去 查阅 文档 
的 矿 烦 。 对 于 熟悉 POM 的 用 户 来 说 ， 代 码 提示 也 可 以 帮助 他 们 市 省 输 
入 时 间 。 


16.7.2 Effective POM 


我 们 都 知道 ， 任 何 一 个 项 目的 POM 都 至 少 继承 自 Maven 内 置 的 超 
级 POM， 有 些 项 目 中 用 户 还 会 配置 自己 的 继承 层次 。 也 就 是 说 ， 单 从 
当前 的 POM 是 无 法 全 面 了 解 项 目 信息 的 ， 你 必须 同时 查看 所 有 父 
POM 。Maven 有 一 个 Effective POM 的 概念 ， 它 表示 一 个 合并 整个 继承 
结构 所 有 信息 的 POM。 假 设 项 目 A 继承 自 项 目 B， 而 B 又 隐 式 地 继承 自 
超级 POM， 那 么 A 的 Effective POM 就 包含 了 所 有 A、B 以 及 超级 POM 的 
配置 。 有 了 Effective POM， 用 户 就 能 一 次 得 到 完整 的 POM 信 息 。 


Maven 用 户 可 以 直接 从 命令 行 获得 Effective POM: 


$ mvn help:effective -pom 


JTEm2eclipsef J POM tn FP, AiR] AEffective POM, H 
可 以 直接 查看 当前 项 目的 Effective POM， 如 图 16-26 所 示 。 当 然 ， 由 于 
这 是 一 个 由 其 他 POM 合 并 而 来 的 文件 ， 你 将 无 法 对 其 直接 进行 修改 。 


<?xml version="1.0"?> 
<project xsi:schemaLocation="http: //maven.apache.org/POM/4.0.0 http://maven.apache.o 
xmins:xsi="http://vvv.v3.org/2001/XMLSchema—instance"> 
<modelVersion>4.0.0</modelVersion> 
<parent> 
<artifactid>account—parent</artifactid> 
<groupId>com. juvenxu.mvnbook.account</groupId> 
<version>1.0.0-SNAPSHOT</version> 
<relativePath>../account-—parent/pom.xml</relativePath> 
</parent> 
<groupId>com. juvenxu.mvnbook. account</groupId> 
<artifactiId>account-persist</artifactid> 
<version>1.0.0-SNAPSHOT</version> 
<name>Account Persist</name> 
<properties> 
<springframework.version>2.5.6</springframework.version> 
<dom43 .version>1.6.1</dom4j.version> 
<junit.version>4.7</junit.version> 
</properties> 
<dependencyManagement> 
<dependencies> 
<dependency> 
<groupid>org.springframework</groupiId> 
<artifactiId>spring-—core</artifactid> 
<version>2.5.6</version> 
</dependency> 
ey es, e 


eee eee 


116-26 Effective POM 


16.7.3 下载 依赖 源码 


m2eclipse 能 够 自动 下 载 并 使 用 依赖 的 源码 包 ， 当 你 需要 探究 第 三 
方 开 源 依 赖 的 细 市 ， 或 者 在 调试 应 用 程序 的 时 候 ， 这 一 特性 非常 有 
用 。 当 然 ， 该 功能 的 前 提 是 依赖 提交 了 相应 的 源码 包 至 Maven 仔 库 ， 通 
常 这 个 源码 包 是 一 个 classifier 为 sources 的 jar 文 件 。 例 如 junit-4.8.1.jar 就 
有 一 个 对 应 的 junit-4.8.1-sources.jar 源 码 包 。 


m2eclipse 用 户 可 以 在 项 目 上 或 者 pom.xml 上 右 击 ， 选 择 Maven， 再 
选择 Download Sources 让 m2eclipse 为 当前 项 目的 依赖 下 载 源码 包 。 也 可 
以 设置 Maven 首 选项 计 m2eclipse 默 认 目 动 下 载 源 码 包 。 方 法 是 单 击 
Eclipse 荣 单 中 的 Window 并 选择 Preferences， 然 后 在 弹出 的 对 话 框 左 边 
选择 Maven， 接 着 在 右边 选 上 Download Artifact Sources， 如 图 16-27 所 


AN? 


S Preferences 


type filter text Maven 
General 
Ant 
Help 


El Offline 
[E] Debug Output 
Install/Update [7] Download Artifact Sources 
Iai 回 Download Artifact JavaDoc 
vars E] Download repository index updates on startup 
Archetypes [F] Update Maven projects on startup 
Installations E] Hide folders of physically nested modules (experimental) 
POM Editor [F Support multiple Maven modules mapped to a single Eclipse workspace project 
Problem Reporting 
Templates 
User Settings 
Run/Debug Select... 


ee 


Goals to run on project import: 


Tasks Goals to run when updating project configuration: 
Team 

Usage Data Collector 
Validation 


process-resources | Select... 


| Restore Defaults | | Apply 


| OK | Cancel | 


图 16-27 开启 源码 包 下 载 


从 图 16-27 中 读者 还 可 以 看 到 ，Maven 首 选项 允许 配置 很 多 
m2eclipse 的 默认 行为 ， 包 括 是 否 开局 Debug 输 出 、 是 否 打开 Eclipse 整 下 
载 索 引 等 。 左 边 的 Maven 子 项 还 允许 用 户 做 更 多 的 配置 ， 包 括 配 置 
m2eclipse 使 用 的 Maven 安 装 、 目 定义 settings.xml 文 件 等 。 读 者 可 以 根据 
目 己 的 实际 需要 进行 调整 ， 这 里 不 再 发 述 。 


16.8 小结 


笔者 不 推荐 在 不 熟悉 Maven 命 令 行 的 情况 下 就 使 用 m2eclipse， 如 
果 不 理解 Maven 的 基本 概念 和 命令 行 操作 ， 华 丽 的 IDE 界 面 只 能 给 你 带 
来 更 多 的 困惑 ， 尤 其 是 当 遇 到 问题 的 时 候 ， 由 于 牵扯 了 更 多 的 非 
Maven 因 素 ， 排 疑 会 变 得 更 加 困难 。 


如 果 你 已 经 熟悉 了 Maven 的 基本 概念 和 命令 行 ， 并 且 你 日 常 使 用 
的 IDE 是 Eclipse， 那 么 就 大 胆 使 用 m2eclipse 吧 。 你 可 以 在 m2eclipse 中 
直接 创建 Maven 项 目 ， 也 可 以 从 本 地 或 者 SCM 仓 库 导 入 Maven 项 目 ， 
在 m2eclipse 中 执行 mvn 命 令 也 很 方便 ， 你 还 可 以 目 定义 并 保存 mvn 命 
令 。m2eclipse 还 集成 了 Maven 仓 库 客 户 端的 功能 ， 不 用 离开 IDE， 用 户 
就 可 以 浏览 和 搜索 Maven 人 仓库， 并 且 随 时 添加 依赖 。m2eclipse 提 供 的 
依赖 分 析 功 能 也 比 命令 行 更 加 直观 和 清晰 。 除 了 这 些 主要 特性 ， 
m2eclipse 还 能 让 用 户 享 受 便捷 的 POM 编 辑 代 码 提示 ， 可 以 直接 查看 
Effective POM， 以 及 自动 下 载 使 用 依赖 的 源码 包 ， 这 些 功能 都 能 大 大 
提高 日 常 开发 的 效率 。 


第 17 草 ”编写 Maven 插 件 


-编写 Maven 插 件 的 一 般 步 又 

案例 : 编写 一 个 用 于 代码 行 统计 的 Maven 揪 件 
.Mojo 标 注 

.Mojo 参 数 

-错误 处 理 和 日 志 

-测试 Maven 插 件 

:小结 


本 书 第 7 草 已 经 讲 过 ，Maven 的 任何 行为 都 症 由 插件 完成 的 ， 包 括 
项 目的 清理 、 编 译 、 测 试 以 及 打包 等 操作 都 有 其 对 应 的 Maven 插 件 。 
每 个 插件 拥有 一 个 或 者 多 个 目标 ， 用 户 可 以 直接 从 命令 行 运行 这 些 插 
件 目标 ， 或 者 选择 将 目标 绑 定 到 Maven 的 生命 周期 。 


大 量 的 Maven 揪 件 可 以 从 Aapchel 和 Codehausl21 获 得 ， 这 里 的 近 百 
个 插件 几乎 能 够 满足 所 有 Maven 项 目的 需要 。 除 此 之 外 ， 还 有 很 多 


Maven 插 件 分 布 在 Googlecode、Sourceforge、Github 等 项 目 托管 服务 
中 。 因 此 ， 当 你 发 现 目 己 有 特殊 需要 的 时 候 ， 首 移 应 该 搜索 一 下 看 是 
否 已 经 有 现成 的 插件 可 供 使 用 。 例 如 ， 如 采 想 要 配置 Maven 目 动 为 所 
有 Java 文 件 的 头 部 添加 许可 证 声明 ， 那 么 可 以 通过 关键 字 maven plugin 
license 找 到 maven-license-pluginl3l， 这 个 托管 在 Googlecode 上 的 项 目 完 
全 能 够 满足 我 的 需求 。 


在 一 些 非常 情况 下 (几率 低 于 1%) ， 你 有 非常 特殊 的 需求 ， 并 且 
无 法 找到 现成 的 插件 可 供 使 用 ， 那 么 殉 只 能 目 己 编写 Maven 插 件 了 。 
编写 Maven 插 件 并 不 是 特别 复 洒 ， 本 章 将 详细 介绍 如 何 一 步 步 编 写 能 
够 满足 目 己 需要 的 Maven 搬 件 。 


[1] 网 址 为 : http://maven.apache.org/plugins/index.html ° 
[2] 网 址 为 : http://mojo.codehaus.org/plugins.html ° 


[3] 网 址 为 : http://code.google.com/p/maven-license-plugin/。 


17.1 编写 Maven 插 件 的 一 般 步 又 


为 了 能 让 读者 对 编写 Maven 插 件 的 方法 和 过 程 有 一 个 总 体 的 认 
识 ， 下 面 先 简要 介绍 一 下 编写 Maven 皇 件 的 主要 步 又 。 


1) 创建 一 个 maven-plugin 项 目 : 插件 本 身 也 是 Maven 项 目 ， 特 殊 
的 地 方 在 于 它 的 packaging 必 须 是 maven-plugin， 用 户 可 以 使 用 maven- 
archetype-plugin 快 速 创建 一 个 Maven 插 件 项 目 。 


2) 为 插件 编写 目标 : 每 个 插件 都 必须 包含 一 个 或 者 多 个 目标 ， 
Maven 称 之 为 Mojo 〈 与 POJO 对 应 ， 后 者 指 Plain Old Java Object， 这 里 
指 Maven Old Java Object) 。 编 写 插 件 的 时 候 必 须 提供 一 个 或 者 多 个 继 
承 目 AbstractMojo 的 类 。 


3) 为 目标 提供 配置 点 : 大 部 分 Maven 揪 件 及 其 目标 都 是 可 配置 
的 ， 因 此 在 编写 Mojo 的 时 候 需 要 注意 提供 可 配置 的 参数 。 


4) 编写 代码 实现 目标 行为 : 根据 实际 的 需要 实现 Mojo 。 


5) 错误 处 理 及 日 志 : 当 Mojo 发 生 有 异常 时 ， 根 据 情 况 控 制 Maven 的 
运行 状态 。 在 代码 中 编写 必要 的 日 志 以 便 为 用 户 提供 足够 的 信息 。 


6) 测试 插件 ， 编 写 自 动 化 的 测试 代码 测试 行为 ， 然 后 再 实际 运行 
插件 以 验证 其 行为 。 


17.2 案例: 编写 一 个 用 于 代码 行 统计 的 Maven 插 
fF 


为 了 便于 大 家 实践 ， 下 面 将 详细 演示 如 何 实际 编写 一 个 简单 的 用 
于 代码 行 统计 的 Maven 插 件 。 使 用 该 插件 ， 用 户 可 以 了 解 到 Maven 项 目 
中 各 个 源 代码 目录 下 文件 的 数量 ， 以 及 它们 加 起 来 共有 和 多少 代 码 行 。 
不 过 ， 笔 者 强烈 反对 使 用 代码 行 来 考核 程序 员 ， 因 为 大 家 都 知道 ， 代 
码 的 数量 并 不 能 真正 反映 一 个 程序 员 的 价值 。 


要 创建 一 个 Maven 插 件 项 目 ， 首 先 使 用 maven-archetype-plugin 命 


人 
La 
S myn ar che CYpPe:gener ate 


然后 选择 : 


maven-archetype-plugin (An archetype which contains a sample Maven plugin. } 


输入 Maven 坐 标 等 信息 之 后 ， 一 个 Maven 择 件 项 目 就 创建 好 了 。 打 
开 项 目的 pom.xml 可 以 看 到 如 代码 清单 17-1 所 示 的 内 容 。 


代码 清单 17-1 ”代码 行 统计 插件 的 POM 


<project xmlns = "http://maven. pang org /POM/4.0.0" 
xmlns :xsi = “http://www. w- orgji 2001 /X ML Schema 一 


"http: 


insta 
/maven. apac org/P OM /4 .0.0 
org /maven -v4_0_0. ae -5 
<modelVersion >4.0.0 < /model 


lVersion > 
<groupId >com. juvenxu.mvnbook < 


xSi:schemaLocation = 


http://maven. apache. 


/groupid > 
{1 >maven -loc -plugin < /artifactId> 
g >maven -plugin < /packaging > 

) .1 —SNAPSHOT < /version > 


ww. Juvenxu.com/ < /Ur 


< dependencies > 
< dependency > 
<grouplId >org. apache. maven < fare ipId> 
<artifactId >maven —plugin -api < /artifactId> 
<version> $ {maven. version} 
< /dependency > 
< /dependencies > 
< /project > 


< ea "sion 


Maven 插 件 项 目的 POM 有 两 个 特殊 的 地 方 : 


an 


1) 它 的 packaging 必 须 为 maven-plugin， 这 种 特殊 的 打包 类 型 能 
制 Maven 为 其 在 生命 周期 阶段 绑 定 插件 处 理 相关 的 目标 ， 例 如 在 
compile 阶 段 ，Maven 需 要 为 插件 项 目 构建 一 个 特殊 插件 描述 符 文件 。 


2) 从 上 述 代码 中 可 以 看 到 一 个 artifactId 为 maven-plugin-api 的 依 


赖 ， 该 依赖 中 包含 了 插件 开发 所 必需 的 类 ， 例 如 稍 后 会 看 到 的 


AbstractMojo。 需 要 注意 的 是 ， 代 码 清单 17-1 中 并 没有 使 用 默认 


Archetype 生 成 的 maven-plugin-api 版 本 ， 而 是 升级 到 了 3.0， 这 样 做 的 目 
的 是 与 Maven 的 版 本 保持 一 致 。 


插件 项 目 创建 好 之 后 ， 下 一 步 是 为 插件 编写 目标 。 使 用 Archetype 
生成 的 插件 项 目 包 仿 了 一 个 名 为 MyMojo 的 Java 文 件 ， 我 们 将 其 删除 ， 
然后 自己 创建 一 个 CountMojo， 如 代码 清单 17-2 所 示 。 


代码 清单 17-2 ”CountMojo 的 主要 代码 


jn 


# Goal which counts lines of code of a project 
= 


+ @ goal count 
| 
public class CountMojo 


extends AbstractMojo 
{ 


private static final String[] INCLUDES DEFAULT = { "java", "xml", "properties" 


fee 
+ @ parameter expression =" $ {project.basedir}" 
+ @ required 
+ @ readonly 
=/ 
private File basedir; 


fw 


+ @ parameter expression =" $ {project. build. sourceDirectory}" 
+ @ required 

* @ readonly 

=/ 


private File sourceDirectory; 


PE 


+ @ parameter expression =" $ {project. build. testSourceDirectory}" 
* @ required 

* @ readonly 

= / 


privale File testSourceDirectory; 


fe 


+ @ parameter expression ="$ {project. build. resources}” 
* @ required 

* @ readonly 

a/ 


private List <Resource > resources; 

A 
* @ parameter expression =" $ {project.build.testResources}" 
* @ required 


* @ readonly 
a / 


private List <Resource > testResources; 


wm 


* The file types which will be included for counting 
* 
* @ parameter 
* vA 
private String[] includes; 


public void execute () 
throws MojoExecutionException 


if (includes = = null || includes.length = = 0 ) 
{ 
includes = INCLUDES_DEFAULT; 
} 
J 
tr 


countDir( sourceDirectory ); 


countDir( testSourceDirectory ); 


for ( Resource resource : resources ) 


resource. getDirectory () ) ); 


countDir ( new File 
} 


for ( Resource resource : testResources ) 
{ 
countDir (new File ( resource. getDirectory(} ) ); 


1 
i 
atch ( IOExceptione ) 


throw new MojoExecutionException( "Unable to count lines of code.",e ); 


首先 ， 每 个 插件 目标 类 ， 或 者 说 Mojo， 都 必须 继承 AbstractMojo 并 
实现 execute () 方法 ， 只 有 这 样 Maven 才 能 识别 该 插件 目标 ， 并 执行 
execute () 方法 中 的 行为 。 其 次 ， 由 于 历史 原因 ， 上 述 CountMojo 类 使 
用 了 Java 1.4 风 格 的 标注 (将 标注 写 在 注释 中 ) ， 这 里 要 关注 的 是 
@goal， 任 何 一 个 Mojo 都 必须 使 用 该 标注 写 明 目 己 的 目标 名 称 ， 有 了 有 目 
标定 义 之 后 ， 我 们 才能 在 项 目 中 配置 该 插件 目标 ， 或 者 在 命令 行 调用 
之 。 例 如 : 


$ mvn com. juvenxu.mvnbook :maven-loc-plugin:0.0.1-SNAPSHOT:count 


创建 一 个 Mojo 所 必要 的 工作 就 是 这 三 项 :继承 AbstractMojo、 实 现 
execute () 方法 、 提 供 @goal 标 注 。 


下 一 步 是 为 插件 提供 配置 点 。 我 们 希望 该 插件 默认 统计 所 有 Java、 
XML， 以 及 properties 文 件 ， 但 是 允许 用 户 配置 包含 哪些 类 型 的 文件 。 
代码 清单 17-2 中 的 includes 字 段 就 是 用 来 为 用 户 提供 该 配置 点 的 ， 它 的 
类 型 为 String 数 组 ， 并 且 使 用 了 @parameter 参 数 表示 用 户 可 以 在 使 用 该 
插件 的 时 候 在 POM 中 配置 该 字段 ， 如 代码 请 单 17-3 所 示 。 


代码 清单 17-3 ”配置 CountMojo 的 includes 参 数 


lugit 
<groupId >com. juvenxu.mvnbook < /grouplId > 
<artifactId >maven -loc -plugin < /artifactId > 
version >0.0.1—-—SNAPSHOT < /version > 
col guratio 
include 
nclude nc de 


< /includes > 
/configuration > 


< /executions > 


代码 清单 17-3 配 置 了 CountMojo 统 计 Java 和 SQL 文件 ， 而 不 是 默认 
的 Java、XML 和 Properties。 


代码 清单 17-2 中 还 包含 了 basedir、sourceDirectory、 
testSourceDirectory 等 字段 ， 它 们 都 使 用 了 @parameter 标 注 ， 但 同时 天 


Bi F expression KRMAR EEG ILS FAI o $ 
{project.basedir} ` $ {project.build.sourceDirectory} ` $ 
{project.build.testSourceDirectory} 等 表达 式 读者 应 该 已 经 熟悉 ， 它 们 分 
别 表示 了 项 目的 基础 目录 、 主 代码 目录 和 测试 代码 目录 。@readonly 标 
注 表 示 不 允许 用 户 对 其 进行 配置 ， 因 为 对 于 一 个 项 目 来 说， 这 几 个 目 
永 位 置 都 是 固定 的 。 


了 人 解 这 些 人 简单 的 配置 点 之 后 ， 下 一 步 束 该 实现 插件 的 具体 行为 
了 。 从 代码 清单 17-2 的 execute () 方法 中 大 家 能 看 到 这 样 一 些 信息 : 
如 膝 用 户 没有 配置 includes 则 就 古 用 默认 的 统计 包含 配置 ， 然 后 再 分 别 
统计 项 目 主 代码 目录 、 测 试 代码 目录 、 主 俯 源 目录 ， 以 及 测试 资源 目 
录 。 这 里 涉及 一 个 countDir () 方法 ， 其 具体 实现 如 代码 清单 17-4 所 


修 ° 


代码 清单 17-4 ”CountMojo 的 具体 行为 实现 


ivate void countDir( File dir ) 


throws IOException 


for ( File sourceFile : collected ) 
{ 

lines + = countLine( sourceFile ); 
} 


String path = dir. getAbsolutePath ()}. substring ( basedir.getAbsolutePath () 
- length () ); 


getLog().info{ path + ": " + lines + * lines of code in" + collected.size() + 
"files" ); 


} 


private void collectFiles (List <File> collected, File file ) 
{ 
if ( file.isFile() ) 
{ 
for (String include : includes ) 


{ 
if { file. getName().endsWith("." + include ) ) 
{ 
collected.add( file ); 
break; 
} 
} 
} 
else 
{ 
for (File sub: file. listFiles() ) 
{ 
collectFiles( collected, sub ); 
} 
} 


} 


private int countLine( File file ) 
throws IOException 
{ 
BufferedReader reader = new BufferedReader ( new FileReader( file ) ); 


int line = 0; 
try 


{ 
while ( reader. ready () ) 


{ 
reader, readLine(); 
line ++; 
} 
} 
finally 
{ 


reader.close(); 


这 里 简单 解释 一 下 上 述 三 个 方法 : collectFiles () 方法 用 来 递归 地 
收集 一 个 目录 下 所 有 应 当 被 统计 的 文件 ，countLine () 方法 用 来 统计 
单个 文件 的 行 数 ， 而 countDir () 则 借助 上 述 两 个 方法 统计 某 一 目录 下 
共有 和 多少 文 件 被 统计， 以 及 这 些 文件 共 包 售 了 多 少 代码 行 。 


代码 清单 17-2 中 的 execute () 方法 包含 了 简单 的 异常 处 理 ， 代 码 
行 统 计 的 时 候 由 于 涉及 了 文件 操作 ， 因 此 可 能 会 抛 出 IOException。 当 
捕获 到 IOException 的 时 候 ， 使 用 MojoExecutationException 对 其 简单 包 
装 后 再 抛 出 ，Maven 执 行 插件 目标 的 时 候 如 果 遇 到 


MojoExecutationException， 驳 会 在 命令 行 显 示 “BUILD ERROR” 信 息 。 


代码 清单 17-4 中 的 countDir () 方法 的 最 后 一 行使 用 了 
AbstractMojo 的 getLog () 方法 ， 该 方法 返回 一 个 类 似 于 Log4j 的 日 志 对 
象 ， 可 以 用 来 将 输出 日 志 到 Maven 命 令 行 。 这 里 使 用 了 info 级 别 的 日 志 
告诉 用 户 某 个 路 径 下 有 和 多少 文件 被 统计 ， 共 包含 了 多 少 代 码 行 ， 因 此 
在 使 用 该 插件 的 时 候 可 以 看 到 如 下 的 Maven 输 出 : 


[INFO] ---maven -loc —plugin:0.0.1—SNAPSHOT:count (default) @ app ——- 
INFO) \src main \java: 13 lines of code in 1 files 
[INFO] src test \java: 38 lines of code in 1 files 


使 用 mvn clean install 命 令 将 该 插件 项 目 构建 并 安装 到 本 地 仓库 后 ， 
驶 能 使 用 它 统计 Maven 项 目的 代码 行 了 。 如 下 所 示 : 


$ mvn com. juvenxu.mvnbook :maven — loc - plugin:0.0.1 —SNAPSHOT:count 

[INFO] Scanning for projects... 

[INFO 

INEO TT E 


[INFO] Building Account Captcha 1.0.0 - SNAPSHOT 


[INEO] eene aa a A a 
[INFO] 
[INFO] —--maven-loc —plugin:0.0.1-SNAPSHOT:count (default-cli) @ account-cap- 


[INFO] \sre\main\java: 179 lines of code in 4 files 
[INFO] \sre\test \java: 112 lines of code in2 files 
[INFO] \sre\main\resources: 11 lines of code in 1 files 
[INFO] \sre\test \resources: 0 lines of code in 0 files 


[INFO] 一 一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] BUILD SUCCESS 

[INFO] 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Total time: 0.423s 

[INFO] Finished at: Sat Jun 05 16:28:35 CST 2010 

[INFO] Final Memory: 1M/4M 

[INFO] -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


如 采 嫌 命令 行 太 长 太 复 杂 ， 可 以 将 该 插件 的 groupId 添 加 到 
settings.xml 中 。 如 下 所 示 : 


<settings > 
<pluginGroups > 
<pluginGroup > Com. juvenxu. mvnbook < /pluginGroup > 


< /pluginGroups > 
< /settings > 


现在 Maven 命 令 行 就 可 以 简化 成 : 


$ mvn loc:count 


这 里 面 的 具体 原理 可 参考 7.8.4 节 。 


17.3. ”Mojo 标 注 


每 个 Mojo 都 必须 使 用 @Goal 标 注 来 注 明 其 目标 名 称 ， 否 则 Maven 将 
无 法 识别 该 目标 。Mojo 的 标注 不 仅 限于 @Goal， 以 下 是 一 些 可 以 用 来 
控制 Mojo 行 为 的 标注 。 


-@goal<name> 


这 韦唯 一 必须 声明 的 标注 ， 当 用 户 使 用 命令 行 调 用 插件 ， 或 者 在 
POM 中 配置 插件 的 时 候 ， 都 需要 使 用 该 目标 名 称 。 


-@phase<phase> 


默认 将 该 目标 绑 定 至 Default 生 命 周 期 的 某 个 阶段 ， 这 样 在 配置 使 
用 该 插件 目标 的 时 候 就 不 需要 声明 phase。 例 如 ，maven-surefire-plugin 
的 test 目 标 就 带 有 Q@phase test 标 注 。 


-@requiresDependencyResolution<scope> 


表示 在 运行 该 Mojo 之 前 必须 解析 所 有 指定 范围 的 依赖 。 例 如 ， 
maven-surefire-pluginf‘}test E #74778 @requiresDependencyResolution test 
标注 ， 表 示 在 执行 测试 之 前 ， 所 有 测试 范围 的 依赖 必须 得 到 解析 。 这 
里 可 用 的 依赖 范围 有 compile、test 和 runtime， 默 认 值 为 runtime ° 


-@requiresProject<true/false> 


表示 该 目标 是 否 必须 在 一 个 Maven 项 目 中 运行 ， 默 认为 true。 大 部 
分 插件 目标 都 需要 依赖 一 个 项 目 才能 执行 ， 但 有 一 些 例外 。 例 如 
maven-help-plugin 的 system 目 标 ， 它 用 来 显示 系统 属性 和 环境 变量 信 
上 息 ， 不 需要 实际 项 目 ， 因 此 使 用 了 @requiresProject false 标 注 。 另 外 ， 
maven-archetype-plugin 的 generate 目 标 也 是 一 个 很 好 的 例子 。 


-@requiresDirectInvocation<true/false> 
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在 POM 中 将 其 绑 定 到 生命 周期 阶段 ，Maven 就 会 报错 ， 默 认 值 为 false。 
如 果 你 希望 编写 的 插件 只 能 在 命令 行 独立 运行 ， 就 应 当 使 用 该 标注 。 


-@requiresOnline<true/false> 


表示 是 否 要 求 Maven 必 须 十 在 线 状态 ， 默认 值 十 false。 


-@requiresReport<true/false> 


表示 是 否 要 求 项 目 报告 已 经 生成 ， 黑 认 值 是 false。 


“(Vaggregator 


当 Mojo 在 多 模块 项 目 上 运行 时 ， 使 用 该 标注 表示 该 目标 只 会 在 顶 


层 模 块 运行 。 例 如 maven-javadoc-plugin 的 aggregator-jar 人 使 用 了 


@aggregator 标 注 ， 它 不 会 为 多 模块 项 目的 每 个 模块 生成 Javadoc， 而 是 
在 顶层 项 目 生成 一 个 已 经 聚合 的 Javadoc 文 档 。 


-@execute goal=“<goal>” 


在 运行 该 目标 之 前 先 让 Maven 运 行 另外 一 个 目标 ， 如 果 是 本 插件 的 
目标 ， 则 直接 使 用 目标 名 称 ， 人 否则 使 用 "prefix: goal” 的 形式 ， 即 注 明 
目标 前 级 。 例 如 ，maven-pmd-plugin 是 一 个 使 用 PMD 来 分 析 项 目 源码 的 
工具 ， 它 包含 pmd 和 check 等 目标 ， 其 中 pmd 用 来 生成 报告 ， 而 check 用 
来 验证 报告 。 由 于 check 是 依赖 于 pmd 生 成 的 内 容 的 ， 因 此 可 以 看 到 它 
使 用 了 标注 @execute goal=“pmd” ° 


-@execute phase=“<phase>” 


在 运行 该 目标 之 前 让 Maven 先 运行 一 个 并 行 的 生命 周期 ， 到 指定 的 
阶段 为 止 。 例 如 maven-dependency-plugin 的 analyze 使 用 了 标注 @execute 
phase="test-compile"， 因 此 当 用 户 在 命令 行 执行 dependency: analyze 的 
时 候 ，Maven 会 首先 执行 default 生 命 周 期 所 有 至 test-compile 的 阶段 。 


-@execute lifecycle=“<lifecycle>”phase=“<phase>” 


在 运行 该 目标 之 前 让 Maven 先 运行 一 个 自 定 义 的 生命 周期 ， 到 指定 
的 阶段 为 止 。 例 如 maven-surefire-report-plugin 这 个 用 来 生成 测试 报告 的 
插件 ， 它 有 一 个 report 目 标 ， 标 注 T @execute 


yous ya 


phase="test"lifecycle="surefire" ， 表 示 运 行 这 个 和 目 定 义 的 surefire 声 明 周 
期 至 test 阶 段 。 目 定义 生命 周期 的 配置 文件 位 于 
src/main/resources/META-INF/maven/lifecycle.xml。 内容 如 代码 清单 17-5 
MA 


代码 清单 17-5 ”maven-surefire-report-plugin 的 目 定义 生命 周期 


figuration > 
<testPailureIgnore >true < /testFailurelIgnore > 


< /configuration > 


17.4 ” Mojo 参数 


正如 在 代码 清单 17-2 中 所 看 到 的 那样 ， 我 们 可 以 使 用 @parameter 将 
Mojo 的 某 个 字段 标注 为 可 配置 的 参数 ， 即 Mojo 参 数 。 事 实 上 几乎 每 个 
Mojo 都 有 一 个 或 者 多 个 Mojo 参 数 ， 通 过 配置 这 些 参数 ，Maven 用 户 可 
以 自 定义 插件 的 行为 。7.5.2 节 和 7.5.3 节 就 分 别 配置 了 maven-compiler- 


X 


plugin 和 maven-antrun-plugin 的 Mojo 参 数 ° 


Maven 文 持 种 类 多 样 的 Mojo 参 数 ， 包 括 单 值 的 boolean ` int ` 
float、String、Date、File 和 URL， 多 值 的 数组 、Collection、Map、 


Properties 等 。 


.boolean (包括 boolean 和 Boolean，) 


Fá x & 
* @ parameter 
x / 


private boolean sampleBoolean 


对 应 的 配置 如 下 : 


<sampleBoolean >true < /sampleBoolean > 


int (包括 Integer ` long ` Long ` short ` Short ` byte ` Byte) 


der et 


* @ parameter 
| 


private int sampleInt 
对 应 的 配置 如 下 : 


<sampleiInt >8 < /sampleInt > 


-float (包括 Float、double、Double) 


fa & 
+ @ parameter 
x / 


private float sampleFloat 
对 应 的 配置 如 下 : 


<sampleFloat >8.8 < /sampleFloat > 


‘String (包括 StringBuffer ` char ` Character) 


J ER 


+ @ parameter 


* / 


private String sampleString 
对 应 的 配置 如 下 : 


<sampleString >Hello World < /sampleString > 


‘Date (格式 为 yyyy-MM-dd HH: mm: ss.S a 或 者 yyyy-MM-dd 


HH: mm: ssa) 


fe esl ae 


* @ parameter 
* / 


private Date sampleDate 


对 应 的 配置 如 下 : 

< sampleDate >2010 -06 -06 3:14:55.1 PM< /sampleDate > 
或 者 

< sampleDate >2010 -06 -06 3:14:55PM< /sampleDate > 
‘File 


PE *® 


* @ parameter 
x / 


private File sampleFile 
对 应 的 配置 如 下 : 
< sampleFile >c:\tmp< /sampleFile > 
“URL 


Kies 


* @ parameter 
*/ 
private URL sampleURL 


对 应 的 配置 如 下 : 


< sample =URL >http://www. juvenxu. com/ < /sampleURL > 
BAA 


/*® * 


* @ parameter 
x / 


private String[] includes 


对 应 的 配置 如 下 : 


<includes> 


< include > java < /include > 
< include >sal < /include > 
< /includes > 


‘Collection (任何 实现 Collection 接 口 的 类 ， 如 ArrayList 和 HashSet) 


/* * 


* @ parameter 
* / 


private List includes 
对 应 的 配置 如 下 : 


<includes > 


< include > java < /include > 


< include >sal < /include > 
< /includes > 


‘Map 


fem 
* @ parameter 
* / 


private Map sampleMap 


对 应 的 配置 如 下 : 


<sampleMap > 
<keyl >valuel < /key2 > 
<keyl >value2 < /key2 > 
< /sampleMap > 


-Properties 


(* # 
* @ parameter 
* / 


private Properties sampleProperties 


对 应 的 配置 如 下 : 


<sampleProperties > 
<property > 
<name >p_name_i < /name > 
<value >D_Value 1 < /value > 
</property > 
<property > 
<name >p_name_2 < /name > 
<value >p_value_2 < /value > 
< /property > 
< /sampleProperties > 
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段 ， 不 过 在 此 基础 上 ， 用 户 还 能 为 @parameter 标 注 提 供 一 些 额 外 的 属 
性 ， 进 一 步 自 定义 Mojo 参 数 。 


-@parameter alias=“<aliasName>” 


使 用 aliass， 用 户 束 可 以 为 Mojo 参 数 使 用 别名 ， 当 Mojo 字 段 名 称 
长 或 者 可 读 性 不 强 时 ， 这 个 别名 束 非 第 有 用 。 例 如 : 


/ * * 


* @ parameter alias 


/ 
守 / 
/ 


"Wid" 


private String unigquelIdentity 


对 应 的 配置 如 下 : 


‘@parameter expression=“${aSystemProperty }” 


使 用 系统 属性 表达 式 对 Mojo 参 数 进 行 赋值 ， 这 是 非常 有 用 的 特 
性 。 配 置 了 @parameter 的 expression 之 后 ， 用 户 可 以 在 命令 行 配置 该 


Mojo 参 数 。 例 如 ，maven-surefire-plugin 的 test 目 标 有 如 下 源码 : 


= = 


* @ parameter expression="S {maven.test.skip}" 
Ey 


Hr] 


private boolean skip; 


用 户 可 以 在 POM 中 配置 skip 参 数 ， 同 时 也 可 以 直接 在 命令 行使 用 - 
Dmaven.test.skip=true 来 跳 过 测试 。 如 采 Mojo 参 数 没 有 提供 expression， 
那 就 意味 着 该 参数 无 法 在 命令 行 直接 配置 。 还 需要 注意 的 是 ，Mojo 参 
数 的 名 称 和 expression 名 称 不 一 定 相同 。 


-@parameter default-value=“aValue/${anExpression}” 


如 果 用 户 没 有 配置 该 Mojo 参 数 ， 就 为 其 提供 一 个 默认 值 。 该 值 可 
以 是 一 个 简单 字面 量 如 “true”、“hello” 或 者 “1.5”， 也 可 以 是 一 个 表达 
式 ， 以 方便 使 用 POM 的 某 个 元 素 。 


例如 ， 下 面 代码 中 的 参数 sampleBoolean 默 认 值 为 true: 


private boolean sampleBoolean 


代码 清单 17-2 中 有 如 下 代码 : 


Je * 
k @ parameter expression =" $ {project. build. sourceDirector 
@ required 


站 
* Yy pe 
x 
* @ readonly 
/ 
= 


private File sourceDirectory; 
表示 默认 使 用 POM 元 素 <project><build><sourceDirectory> 的 值 。 


除了 @parameter 标 注 外 ， 还 看 到 可 以 为 Mojo 参 数 使 用 @readonly 和 
@required 标 注 。 


-@readonly 
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进行 配置 。 通 音 在 应 用 POM 元 素 内 容 的 时 候 ， 我 们 不 希望 用 户 干涉 。 
代码 请 单 17-2 束 是 很 好 的 例子 。 


-@readonly 


表示 该 Mojo 参 数 是 必须 的 ， 如 宁 使 用 了 该 标注 ， 但 是 用 户 没有 配 
置 该 Mojo 参 数 旦 其 没有 默认 值 ，Maven 束 会 报错 。 


17.5 ”错误 处 理 和 日 志 


如 果 大 家 看 一 下 Maven 的 源码 ， 会 发 现 AbstractMojo 实 现 了 Mojo 接 
O, execute () 方法 正 是 在 这 个 接口 中 定义 的 。 具 体 代 码 如 下 : 


void execute () 


throws MojoExecutionException, MojoFailureException; 


这 个 方法 可 以 抛 出 两 种 异常 ， 分 别 是 MojoExecutionException 和 


MojoFailureException ° 


如 果 Maven 执 行 插件 目标 的 时 候 遇 到 MojoFailureException， 束 会 
显示 “BUILD FAILURE” 的 错误 信息 ， 这 种 异常 表示 Mojo 在 运行 时 发 现 
了 预期 的 错误 。 例 如 maven-surefire-plugin 运 行 后 若 发 现 有 失败 的 测试 


就 会 抛 出 该 异常 。 


如 果 Maven 执 行 插件 目标 的 时 候 遇 到 MojoExecutationException ， 
WLS “BUILD ERROR” 的 错误 信息 。 这 种 异常 表示 Mojo 在 运行 时 
发 现 了 未 预期 的 错误 ， 例 如 代码 清单 17-2 中 我 们 不 知道 代码 行 统计 插 
件 何 时 会 过 到 IOException， 这 个 时 候 只 能 将 其 藤 套 进 


MojoExecutationException 后 再 抛 出 。 


上 述 两 种 异常 能 够 在 Mojo 执 行 出 错 的 时 候 提供 一 定 的 信息 ， 但 这 
往往 是 不 够 的 ， 用 户 在 编写 插件 的 时 候 还 应 该 提供 足够 的 日 志 信息 ， 


AbstractMojo 提 供 了 一 个 getLog () 方法 ， 用 户 可 以 使 用 该 方法 获得 一 
个 Log 对 象 。 该 对 象 支持 四 种 级 别 的 日 志方 法 ， 它 们 从 低 到 高 分 别 


‘debug: 调试 级 别 的 日 志 。Maven 默 认 不 会 输出 该 级 别 的 日 志 ， 不 
过 用 户 可 以 在 执行 mvn 命 令 的 时 候 使 用 -Xx 参数 开局 调试 日 志 ， 该 级 别 
的 日 志 征 用 来 帮助 程序 员 了 解 插件 具体 运行 状态 的 ， 因 此 应 该 尽量 详 
细 。 和 需要 注意 的 是 ， 不 要 指望 你 的 用 户 会 主动 去 看 该 级 别 的 日 志 。 


‘info: 消 娠 级 别 的 日 志 。Maven 默 认 会 输出 该 级 别 的 日 志 ， 该 级 
别 的 日 志 应 该 足够 简洁 ， 帮 助 用 户 了 解 插件 重要 的 运行 状态 。 例 如 ， 
maven-compiler-plugin 会 使 用 该 级 别 的 日 志 告 诉 用 户 源 代码 编译 的 目标 
HK © 


‘warn: 警告 级 别 的 日 志 。 当 插件 运行 的 时 候 遇 到 了 一 些 问 题 或 错 
误 ， 不 过 这 类 问题 不 会 导致 运行 失败 的 时 候 ， 束 应 该 使 用 该 级 别 的 日 
志和 警告 用 户 尽 快 修复 。 


‘error: 错误 级 别 的 日 志 。 当 插件 运行 的 时 候 遇 到 了 一 些 问 题 或 错 
误 ， 并 且 这 类 问题 导致 Mojo 无 法 继续 运行 ， 束 应 该 使 用 该 级 别 的 日 志 


提供 详细 的 错误 信息 。 


上 述 每 个 级 别 的 日 志 都 提供 了 三 个 方法 。 以 debug 为 例 ， 它 们 分 别 


-void debug (CharSequence content) ; 
-void debug (CharSequence content, Throwable error) ; 


.void debug (Throwable error) ; 


用 户 在 编写 插件 的 时 候 ， 应 该 根据 实际 情况 选择 适应 的 方法 。 基 
本 的 原则 是 ， 如 有 果 有 异常 出 现 ， 就 应 该 尽量 使 用 适宜 的 日 志方 法 将 异 
常 堆栈 记录 下 来 ， 方便 将 来 的 问题 分 析 。 


如 有 果 使 用 过 Log4j 之 类 的 日 志 框 染 ， 就 应 该 不 会 对 Maven 日 志文 持 
感到 阳 生 ， 日 志 不 是 一 个 Maven 插 件 的 核心 代码 ， 但 是 为 了 方便 使 用 
和 调试 ， 完 整 的 插件 应 该 具备 足够 丰富 的 日 志 代 码 。 


17.6 ”测试 Maven 插 件 


编写 Maven 插 件 的 最 后 一 步 是 对 其 进行 测试 ， 单 元 测试 较 之 于 一 般 
的 Maven 项 目 无 异 ， 可 以 参考 第 10 章 。 手 动 测 试 Maven 插 件 也 是 一 种 做 
法 ， 读 者 可 以 将 插件 安 半 到 本 地 仓库 后 ， 再 找 个 项 目测 弃 该 插件 。 本 
节 要 介绍 的 并 非 上 述 两 种 读者 已 经 十 分 熟悉 的 测试 方法 ， 而 是 如 何 编 
写 目 动 化 的 集成 测试 代码 来 验证 Maven 插 件 的 行为 。 


读者 可 以 想象 一 下 ， 既 然 是 集成 测试 ， 那 么 就 一 定 需 要 一 个 实际 
的 Maven 项 目 ， 配 置 该 项 目 使 用 插件 ， 然 后 在 该 项 目 上 运行 Maven 构 
建 ， 最 后 再 验证 该 构建 成 功 与 否 ， 可 能 还 需要 检查 构建 的 输出 。 


既然 有 数 以 千 计 的 Maven 插 件 ， 那 么 很 可 能 已 经 有 很 多 人 过 到 过 上 
述 的 需求 ， 因 此 Maven 社 区 有 一 个 用 来 帮助 插件 集成 测试 的 插件 ， 它 就 
是 maven-invoker-plugin。 该 插件 能 够 用 来 在 一 组 项 目 上 执行 Maven， 并 

仿 查 每 个 项 目的 构建 是 否 成 功 ， 最 后 ， 它 还 可 以 执行 BeanShell 或 者 
Groovy 脚 本 来 验证 项 目 构 建 的 输出 。 


BeanShell 和 Groovy 都 是 基于 JVM 平 台 的 脚本 语言 ， 读 者 可 以 访问 
http://www.beanshell.org/ 和 http://groovy.codehaus.org/ 以 了 解 更 多 的 信 
筷 。 本 章 下 面 的 内 容 会 用 到 少许 的 Groovy 代 码 ， 不 过 这 些 代码 十 分 简 
单 ， 很 容易 理解 。 


回顾 一 下 前 面 的 代码 行 统计 播 件 ， 可 以 使 用 Archetype 创 建 一 个 最 
人 简单 的 Maven 项 目 ， 然 后 在 该 项 目 中 配置 maven-loc-plugin。 如 果 一 切 正 
常 ， 就 应 该 能 够 看 到 如 下 的 Maven 构 建 输出 : 


[INFO] \src\main\java: 13 lines of code in 1 files 
38 lines of code in 1 files 


NFO] \sre\test \java: 


为 了 验证 这 一 行为 ， 先 配置 maven-loc-plugin 的 POM 使 用 maven- 


invoker-plugin， 如 代码 清单 17-6 所 示 。 


代码 清单 17-6 ”配置 maven-loc-plugin 使 用 maven-invoker-plugin 


<plugin> 
“groupld >org. apache. maven. plugins < /groupId 
<artifactId >maven-invoker-plugin < /artifactId> 

<version >1.5 < /version > 

<configuration > 


<projectsDirectory >src/it < /projectsDirectory 


<goa 


ostBuildHookScript >validate. groovy < /postBuildHookScript > 


< f/configuration > 
<executions > 
< execution > 
<id>integration-test < /id> 
<goals > 
<goal >install < /goal > 
<goal >run< /goal > 
< /goals> 


fexecution > 


代码 清单 17-6 中 maven-invoker-plugin 有 三 项 配置 。 首 先 
projectDirectory 用 来 配置 测试 项 目的 目录 ， 也 就 是 说 在 src/it 目 录 下 存放 
要 测试 的 Maven 项 目 源 码 ;， 其 次 goals 表 示 在 测试 项 目 上 要 运行 的 Maven 


目标 ， 这 里 的 配置 就 表示 maven-invoker-plugin 会 在 srcit 目 录 下 的 各 个 
Maven 项 目 中 运行 mvn install 命 令 ; 最 后 的 postBuildHookScript 表 示 在 测 
试 完成 后 要 运行 的 验证 脚本 ， 这 里 是 一 个 groovy 文 件 。 


从 代码 清单 17-6 中 我 们 还 看 到 ，maven-invoker-plugin 的 两 个 目标 
instal 和 run 被 绑 定 到 了 integration-test 生 命 周 期 阶段 。 这 里 的 install 目标 
用 来 将 当前 的 插件 构建 并 安装 到 仓库 中 供 测 试 项 目 使 用 ，run 目 标 则 会 
执行 定义 好 的 mvn 命 令 并 运行 验证 脚本 。 


当然 仅仅 该 配置 还 不 够 ，src/it 目 隶 下 必须 有 一 个 或 者 多 个 供 测试 
的 Maven 项 目 ， 我 们 可 以 使 用 maven-archetype-quickstart 创 建 一 个 项 目 
并 修改 POM 使 用 mvn-loc-plugin， 如 代码 清单 17-7 所 示 。 该 测试 项 目的 
ERRED o 


代码 清单 17-7 ”maven-loc-plugin 的 测试 项 目 POM 


<project xmlns = "http://maven. apache. org/POM/4.0.0" 
xmlns:xsi = "http://www. w3.org/2001 /XMLSchema-instance" 
xsi:schemaLocation = "http://maven. apache. org/POM/4.0.0 
http://maven. apache. org/maven-v4_0_0.xsd" > 
<modelVersion >4.0.0 < /modelVersion > 
<groupId >com. juvenxu < /groupId > 
<artifactId>app < /artifactId> 
<packaging > jar < /packaging > 
< version >1.0-SNAPSHOT < /version > 
<name >app < /name > 
<url >http://maven. apache. org < /url > 
< dependencies > 
< dependency > 
<grouplId >junit < /groupId > 
<artifactId>junit < /artifactId > 
<version >3.8.1</version > 
< scope >test < /scope > 
< /dependency > 
< /dependencies > 
<build> 
<plugins > 
<plugin > 
<groupiId > Com. juvenxu. mvnbook < /groupId > 
<artifactId >maven-loc-plugin < /artifactId > 
<version >0.0.1 -SNAPSHOT < /version > 
< executions > 
< execution > 
<goals > 
<goal >count < /goal > 
</goals > 
<phase >verify < /phase > 
< f/execution > 
< fexecutions > 
< /plugin > 
< /plugins > 
< /build> 
< /project > 


代码 清单 17-7 就 是 一 个 最 简单 的 POM， 然 后 配置 maven-loc-plugin 
的 count 目 标 绑 定 到 了 verify 生 命 周 期 阶段 。 


测试 项 目 准 备 好 了 ， 现 在 要 准备 的 是 与 该 项 目 对 应 的 验证 脚本 文 
件 ， 即 validate.groovy， 它 应 该 位 于 src/it/app 目 录 下 〈 即 上 述 测 试 项 目 
的 根 目录 ) ， 内 容 如 代码 清单 17-8 所 示 。 


代码 清单 17-8 maven-loc-plugin 的 集成 测试 验证 脚本 


def file new File (basedir,'build.log') 
def countMain = false 
def countTest false 


file.eachLine { 


if (it =— /BIC ALR; java: 13 lines of code in 1 files/) 
countMain = tru 
if it f/erc.test. java: 38 lines of code in 1 files/) 


ountTest = tr 


i ounth ) 
throw new RuntimeException( "incorrect src/main/java count info" ); 

if ( !countTest ) 
throw new RuntimeException( “incorrect src/test/java count info" ); 


这 段 Groovy 代 码 做 的 事情 很 简单 。 它 首先 读 取 app 项 目 目录 下 的 
build.log 文 件 ， 当 maven-invoker-plugin 构 建 测试 项 目的 时 候 ， 会 把 mvn 
输出 保存 到 项 目下 的 build.log 文 件 中 。 因 此 ， 可 以 解析 该 日 志文 件 来 验 
证 maven-loc-plugin 是 否 输出 了 正确 的 代码 行 信息 


上 述 Groovy 代 码 首 先 假设 没有 找到 正确 的 主 代码 统计 信息 和 测试 
代码 统计 信息 ， 然 后 它 逐 行 允 历 日 志文 件 ， 紧 接着 使 用 正则 表达 式 检 
查寻 找 要 检查 的 内 容 (两 个 斜 杠 // 中 间 的 内 容 是 正则 表达 式 ， 而 =~ 表 示 
寻找 该 正则 表达 式 匹配 的 内 容 ) ， 如 果 找 到 期 望 的 输出 ， 就 将 
countMain 和 countTest 置 为 tue。 最 后 ， 如 末 这 两 个 变量 的 值 有 false， 就 
抛 出 对 应 的 异常 信息 。 


Maven 会 首先 在 测试 项 目 app 上 运行 mvn install 命 令 ， 如 果 运 行 成 
功 ， 则 再 执行 validate.groovy 脚 本 。 只 有 脚本 运行 通过 且 没 有 有 异常 ， 
成 测试 才 算 成 功 。 


现在 在 maven-loc-plugin 下 运行 mvn clean install, WHEA EAI FAY 
输出 : 


[INFO] —--maven - invoker-plugin:1.5:install (integration-test) @ maven-loc- 
plugin --- 


[INFO] Installing D: \ws-maven-book \maven-loc-plugin \pom. xml to D:\java \reposi- 


tory \ com \ juvenxu \ mvnbook \ maven- loc- plugin \0.0.1-SNAPSHOT \ maven- loc- plugin- 
0.0.1-SNAPSHOT. pom 


Installing D: \ws-maven-book \maven-loc-plugin \target \maven-loc-plugin- 


\ Juvenxu \mvnbook \maven-loc-plugin \ 
0.0.1-SNAPSHOT \maven-loc-plugin-0.0.1-SNAPSHOT. jar 


0.0,1-SNAPSHOT. jar to D: \java \repository \com 


[INFO] -—--maven-invoker-plugi Rapes! (integr 


[WARNING] Filtering of parent /c child POMs is not 
jects 


tion-test) @ maven -loc- plugin ——— 
supported without clon ng the pr 


Oo- 


[INFO Building a SER Nea 
NFO . SUCCESS (3.4 8s) 


INFO] Build Summary: 


[INFO] Passed: 1, Failed: 0, Errors: 0, Skipped: 


从 输出 中 可 以 看 到 maven-invoker-plugin 的 install 目标 将 当前 项 目 


maven-loc- ea 库 ， 然 后 它 的 run 目 标 构建 测试 项 目 app， 
并 最 后 报告 运行 结 采 。 


至 此 ， 所 有 Maven 插 件 集成 测试 的 步 又 就 都 完成 了 。 


上 述 样 例 只 涉及 了 maven-invoker-plugin 的 很 少 一 部 分 配置 点 ， 用 
户 还 可 以 配置 : 


debug (boolean) : 是 否 在 构建 测试 项 目的 时 候 开 启 debug 输 出 。 


settingsFile (File) : 执行 集成 测试 所 使 用 的 settings.xml， 默 认为 
本 机 环境 settings.xml ° 


‘localRepositoryPath (File) : 执行 集成 测试 所 使 用 的 本 地 仓库 ， 
默认 就 是 本 机 环境 仓库 。 
:preBuildHookScript (String) : 构建 测试 项 目 之 前 运行 的 


BeanShell 或 Groovy 脚 本 。 


.postBuildHookScript (String) : 构建 测试 项 目 之 后 运行 的 
BeanShell 或 Groovy 脚 本 。 


要 了 解 更 多 的 配置 点 ， 或 者 查看 更 多 的 样 例 。 读 者 可 以 访问 
maven-invoker-plugin 的 站 点 : http://maven.apache.org/plugins/maven- 


invoker-plugin/ ° 
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Maven 社 区 提供 了 成 百 上 千 的 插件 供用 户 使 用 ， 这 些 插件 能 够 满 
足 绝 大 部 分 用 户 的 需求 。 然 而 ， 在 极 少数 的 情况 下 ， 用 户 还 是 需要 编 
写 Maven 插 件 来 满足 自己 非常 特殊 的 需求 。 编 写 Maven 插 件 的 一 般 步 
又 包括 创建 一 个 播 件 项 目 、 编 写 Mojo、 为 Mojo 提 供 配置 点 、 实 现 Mojo 
行为 、 处 理 错误 、 记 录 日 志和 测试 插件 等 。 本 章 实现 了 一 个 简单 的 代 
码 行 统计 插件 ， 并 逐步 展示 了 上 述 步 又 。 用 户 在 编写 自己 插件 的 时 
候 ， 还 可 以 参考 本 章 描 述 的 各 种 Mojo 标 注 、Mojo 参 数 、 异 常 类 型 和 日 
志 接 口 。 本 章 最 后 介绍 了 如 何 使 用 maven-invoker-plugin 实 现 插件 的 自 
动 化 集成 测试 。 


318% Archetype 


本 章 内 容 
-Archetype H ERX 
-a = Archetype 


-Archetype Catalog 
:小结 


3.5 节 已 经 简单 介绍 了 如 何 使 用 Maven Archetype 快 速生 成 项 目 骨 
架 。 读 者 可 以 将 Archetype 理 解 成 Maven 项 目的 模板 ， 例 如 maven- 
archetype-quickstart 就 是 最 简单 的 Maven 项 目 模板 ， 只 需要 提供 基本 的 
JCA (如 groupId、artifactId 及 version 等 ) ， 它 就 能 生成 项 目的 基本 结 
构 及 POM 文 件 。 很 多 著名 的 开源 项 目 (如 AppFuse 和 Apache Wicket) 
都 提供 了 Archetype 方 便 用 户 快速 创建 项 目 。 如 果 你 所 在 组 织 的 项 目 都 
遵循 一 些 通用 的 配置 及 结构 ， 则 也 可 以 为 其 创建 一 个 自己 的 Archetype 
并 进行 维护 。 使 用 Archetype 不 仅 能 让 用 户 快速 简单 地 创建 项 目 ;还 可 
以 鼓励 大 家 遵循 一 些 项 目 结构 及 配置 约定 。 


18.1 Archetypes H EFX 


3.5 节 已 经 介绍 了 Archetype 的 基本 使 用 方法 ， 本 节 进 一 步 解释 相关 
原理 及 一 些 常 用 的 Archetype ° 


18.1.1 Maven Archetype Plugin 


Archetype 并 不 是 Maven 的 核心 特性 ， 它 也 是 通过 插件 来 实现 的 ， 

这 一 插件 就 是 maven-archetype-plugin 

(http://maven.apache.org/archetype/maven-archetype-plugin/) ° REE 
只 是 一 个 插件 ， 但 由 于 其 使 用 范围 非常 广泛 ， 主 要 的 IDE (如 
Eclipse、NetBeans 和 IDEA) 在 集成 Maven 的 时 候 都 着 重 集成 了 


archetype 特 性 ， 以 方便 用 户 快速 地 创建 Maven 项 目 。 


在 本 书 编写 的 时 候 ，maven-archetype-plugin 最 新 的 版 本 是 2.0- 
alpha-5。 需 要 特别 注意 的 是 ， 该 插件 的 1.x 版 本 和 2.x 版 本 差异 很 大 。 在 
1.x 版 本 中 ， 使 用 Archetype 创 建 项 目 使 用 的 目标 是 archetype: create, 

但 这 一 目标 在 2.x 版 本 中 已 经 不 推荐 使 用 了 ， 取 而 代 之 的 是 archetype: 
generate 。 它 们 主要 的 差异 在 于 ， 前 者 要 求 用 户 必 须 一 次 性 地 从 命令 行 
输入 所 有 的 插件 参数 ， 而 后 者 默认 使 用 交互 的 方式 提示 用 户 选 择 或 输 
入 参数 。 不 仅 如 此 ，archetype: generate 也 完全 支持 archetype: create 
的 特性 ， 因 此 用 户 已 经 完全 没有 必要 去 使 用 旧 的 archetype: create 目标 
ne: 


18.1.2 ”使 用 Archetype 的 一 般 步 又 


3.5 太 推荐 用 户 在 使 用 Archetype 搬 件 的 时 候 输 入 完整 的 插件 坐标 ， 
以 防止 Maven 下 载 最 新 的 不 稳定 快照 版 本 。 然 而 这 种 情况 只 是 对 于 
Maven 2 用 户 存 在 ， 在 Maven 3 中 ， 如 果 搬 件 的 版 本 未 声明 ，Maven 只 会 


目 动 解析 最 新 的 发 布 版 ， 因 此 用 户 不 用 担心 引入 快照 版 本 带 来 的 问 
题 。 以 下 是 两 条 命令 的 对 比 : 


‘Maven 3: mvn archetype: generate 


‘Maven 2: mvn org.apache.maven.plugins: maven-archetype- 


plugin: 2.0-alpha-5: generate 


输入 上 述 命令 后 ，Archetype 插 件 会 输出 一 个 Archetype 列 表 供 用 户 
选择 。 例 如 : 


Choose archetype: 
i: internal - > appfuse -basic -jsf {AppFuse archetype for creating a web applica- 
tion with Hibernate, Spring and JSF) 


2: internal — > appfuse -basic -spring (AppFuse archetype for creating a web ap- 
plication with Hibernate, Spring and Spring MVC) 

3: internal - > appfuse -basic -struts (AppFuse archetype for creating a web ap- 
plication with Hibernate, Spring and Struts 2) 

4: internal - > appfuse -basic -tapestry (AppFuse archetype for creating a web ap- 
plication with Hibernate, Spring and Tapestry 4) 


5: internal - > appfuse -core (AppFuse archetype for creating a jar application 
with Hibernate and Spring and XFire) 
6: internal -— > appfuse - modular -jsf (AppFuse archetype for creating a modular 


application with Hibernate, Spring and JSF) 

7: internal — > appfuse -modular -spring (AppFuse archetype for creating a modu- 
lar application with Hibernate, Spring and Spring MVC) 

8: internal - > appfuse ~modular -struts (AppFuse archetype for creating a modu- 
lar application with Hibernate, Spring and Struts 2) 

9: internal - > appfuse -modular -tapestry (AppFuse archetype for creating a modu- 
lar application with Hibernate, Spring and Tapestry 4) 

10: internal - > makumba -archetype (Archetype for a simple Makumba application) 

11: internal - > maven-—archetype -j2ee -simple (A simple J2EE Java application) 


12: internal - > maven -archetype - marmalade -mojo (A Maven plugin development 
project using marmalade) 

13: internal - > maven -archetype -mojo (A Maven Java plugin development project) 

14: internal - > maven-—archetype -portlet (A simple portlet application) 

15: internal - > maven -archetype -profiles () 


16: internal - > maven -archetype -quickstart () 


这 个 列表 来 自 于 名 为 archetype-catalog.xml 的 文件 ，18.3 节 将 对 其 进 
行 深入 解释 。 现 在 ， 用 户 需要 选择 自己 想 要 使 用 的 Archetype， 然 后 输 
其 对 应 的 编号 。 


由 于 Archetype 只 是 一 个 模板 ， 为 了 保持 模板 的 通用 性 ， 它 的 很 多 
重要 内 容 都 是 可 配置 的 。 因 此 ， 在 用 户 选 择 了 一 个 Archetype 之 后 ， 下 
步 就 需要 提供 一 些 基 本 的 参数 。 主 要 有 : 


-sroupld: 想 要 创建 项 目的 groupId。 
-artifactld: 想 要 创建 项 目的 artifactId ° 


version: 想 要 创建 项 目的 version ° 


‘package: 想 要 创建 项 目的 默认 Java 包 名 。 


上 述 参 数 是 Archetype 插 件 内 置 的 ， 也 是 最 常用 和 最 基本 的 。 用 户 
在 自己 编写 Archetype 的 时 候 ， 还 可 以 声明 额外 的 配置 参数 。 


根据 Maven 提 示 填 写 完 配置 参数 之 后 ，Archetype 插 件 就 能 够 生成 
项 目的 骨架 了 。 


18.1.3” 批 处 理 方式 使 用 Archetype 


有 时候 用 户 可 能 不 希望 以 交互 的 方式 使 用 Archetype， 例 如 当 创 建 
Maven 项 目的 命令 在 一 段 自 动 化 的 Shell 脚 本 中 的 时 候 ， 交 互 的 方式 会 
破坏 目 动 化 。 这 时 用 户 可 以 使 用 mvn 命 令 的 -B 先 项， 要求 maven- 
archetype-plugin 以 批 处 理 的 方式 运行 。 不 过 ， 这 时 用 户 还 必须 显 式 地 
声明 要 使 用 的 Archetype 坐 标 信息 ， 以 及 要 创建 项 目的 groupId、 


artifactId、version、package 等 信息 。 例 如 : 


$ > mvn archetype:generate -B \ 
—DarchetypeGroupId =org. apache. maven. archetypes \ 
—DarchetypeArtifactId =maven -archetype -quickstart \ 
—DarchetypeVersion=1.0 \ 
—DgroupId =com. juvenxu.mvnbook \ 
—DartifactIid =archetype -test \ 
—Dversion =1.0 -SNAPSHOT \ 
—Dpackage = com. juvenxu.mvnbook 
[INFO] Scanning for projects... 
[INFO] 
a a a a a 
[INFO] Building Maven Stub Project (No POM) 1 
ee I IIIMIIMIMIssIMsIMstMsstMlMss 
[INFO] 
[INFO] > > > maven - archetype ~ plugin:2.0 -alpha -5:generate (default -cli) @ 
standalone -pom > >> 
[INFO] 
[INFO] < < < maven - archetype —-plugin:2.0 -alpha -5:generate (default —cli) @ 
standalone—pom < < < 
[INFO] 
[INFO] ---maven -archetype -plugin:2.0 -alpha -5 :generate (default -cli) @ stan- 
dalone -pom 一 一 一 
[INFO] Generating project in Batch mode 
[INFO] Archetype repository missing. Using the one from [org. apache. maven. arche- 
types :maven —archetype —quickstart:1.0] found in catalog remote 
[INFO] -一 -一 -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Using following parameters for creating OldArchetype: maven —archetype - 
quickstart :1.0 
[INFO] -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 
[INFO] Parameter: groupId, Value: com, juvenxu. mvnbook 
[INFO] Parameter: packageName, Value: com. juvenxu. mvnbook 
[INFO] Parameter: package, Value: com. juvenxu. mvnbook 
[INFO] Parameter: artifactid, Value: archetype -test 
[INFO] Parameter: basedir, Value: D: \tmp \archetype 
[INFO] Parameter: version, Value: 1.0 -SNAPSHOT 
[INFO] ** *#*# ees # ee ee ee ee ee k End of debug info from resources from 
generated POM **# #e# eee e keke eR ERR RH HH kH 
[INFO] OldArchetype created in dir: D: \tmp \archetype ‘archetype -test 
By ee ES SS eS ee Se eS A a 
[INFO] BUILD SUCCESS 
[INFO] /ee 
[INFO] Total time: 2.6245 
[INFO] Finished at: Wed Apr 28 14:34:32 CST 2010 
[INFO] Final Memory: 6M/11M 
[INFO] mmm ee 


该 例 中 的 Archetype 的 坐标 为 org.apache.maven.archetypes: maven- 
archetype-quckstart: 1.0， 而 真正 要 创建 的 项 目 坐 标 则 为 


com.juvenxu.mvnbook: archetype-test: 1.0-SNAPSHOT ° 


18.1.4 ”常用 Archetype 介 绍 


在 编写 本 书 的 时 候 ，Maven 中 央 仓 库 中 已 经 包含 了 249 个 Archetype 
( 详 见 http://repol.maven.org/maven2/archetype-catalog.xml) 。 此 外 ， 
还 有 大 量 没有 发 布 到 中 央 仓 库 的 Archetype 分 布 在 其 他 Maven 仓 库 中 。 
任何 人 都 不 可 能 全 部 了 解 它 们 ， 因 此 这 里 只 介绍 几 个 比较 常用 的 


Archetype ° 


1.maven-archetype-quickstart 


maven-archetype-quickstart 可 能 是 最 常用 的 Archetype， 当 maven- 


archetype-plugin 提 示 用 户 选 择 Archetype 的 时 候 ， 它 就 是 默认 值 。 使 用 
maven-archetype-quickstart 生 成 的 项 目 十 分 简单 ， 基 本 内 容 如 下 : 


一 个 包含 JUnit 依 赖 声 明 的 pom.xml 。 


“src/main/java 主 代码 目录 及 该 目录 下 一 个 名 为 App 的 输出 “Hello 
World! ”的 类 。 


src/test/java 测 斌 代码 目录 及 该 目录 下 一 个 名 为 AppTest 的 JUnit 测 
试用 例 。 


当 需 要 创建 一 个 全 新 的 Maven 项 目 时 ， 融 可 以 使 用 该 Archetype 生 
成 项 目 后 进行 修改 ， 省 去 了 手工 创建 POM 及 目录 结构 的 麻烦 。 


2.maven-archetype-webapp 


这 是 一 个 最 简单 的 Maven war 项 目 模板 ， 当 需要 快速 创建 一 个 web 
应 用 的 时 候 就 可 以 使 用 它 。 使 用 maven-archetype-webapp 生 成 的 项 目 内 
容 如 下 : 


一 个 packaging 为 war 且 带 有 JUnit 依 赖 声 明 的 pom.xml ° 
:src/main/webapp/ 目 杂 。 
src/main/webapp/index.jsp 文 件 ， 一 个 简单 的 Hello World 页 面 。 


src/main/webapp/WEB-INF/web.xml 文 件 ， 一 个 基本 为 空 的 WebY 
用 配置 文件 。 


3.AppFuse Archetype 


AppFuse 是 一 个 集成 了 很 多 开源 工具 的 项 目 ， 它 由 Matt Raible 开 
发 ， 旨 在 帮助 Java 编 程 人 员 快 速 高 效 地 创建 项 目 。AppFuse 本 吴 使 用 
Maven 构 建 ， 它 的 核心 其 实 束 是 一 个 项 目的 骨架 ， 是 包含 了 持久 层 、 
业务 层 及 展现 层 的 一 个 基本 结构 。 在 AppFuse 2.x 中 ， 已 经 集成 了 大 量 
流行 的 开源 工具 ， 如 Spring、Struts 2、JPA、JSF、Tapestry 等 。 


AppFuse 为 用 户 提 供 了 大 量 Archetype， 以 方便 用 户 快速 创建 各 种 
类 型 的 项 目 ， 它 们 都 使 用 同样 的 groupId org.appfuse。 针 对 各 种 展现 层 


框架 分 别 为 : 
-appfuse-*-jsf: 基于 JSF 展 现 层 框 架 的 Archetype ° 
-appfuse-*-spring: 基于 Spring MVC 展 现 层 框 架 的 Archetype ° 
-appfuse-*-struts: 基于 Struts 2 展现 层 框架 的 Archetype ° 
-appfuse-*-tapestry: 基于 Tapestry 展 现 层 框架 的 Archetype ° 


每 一 种 展现 层 框 架 都 有 3 个 Archetype， 分 别 为 light、basic 和 
modular ° 其中，light 类 型 的 Archetype 只 包含 最 简单 的 骨架 ，basic 类 型 
的 Archetype 则 包含 了 一 些 用 户 管理 及 安全 方面 的 特性 ，modular 类 型 的 
Archetype 会 生成 多 模块 的 项 目 ， 其 中 的 core 模 块 包含 了 持久 层 及 业务 
层 的 代码 ， 而 Web 模 块 则 是 展现 层 的 代码 。 


更 多 关于 AppFuse Archetype 的 信息 ， 读 者 可 以 访问 其 官方 的 快速 


入 门 手册 : http://appfuse.org/display/apf/appfuse+quickstart ° 


18.2 485 Archetype 


也 许 你 所 在 组 织 的 一 些 项 目 都 使 用 同样 的 框架 和 项 目 结构 ， 为 一 
个 个 项 目 重 复 同样 的 配置 及 同样 的 目录 结构 显然 是 难以 让 人 接受 的 。 
更 好 的 做 法 是 创建 一 个 属于 自己 的 Archetype， 这 个 Archetype 包 含 了 一 
些 通用 的 POM 配 置 、 目 隶 结构， 其 至 是 Java 类 及 资源 文件 ， 然 后 在 创 
建 项 目的 时 候 ， 束 可 以 直接 使 用 该 Archetype， 并 提供 一 些 基本 参数 ， 
如 groupId、artifactId、version，maven-archetype-plugin 会 处 理 其 他 原本 
需要 手工 处 理 的 劳动 。 这 样 不 仅 节 省 了 了 时间， 也 降低 了 错误 配置 发 生 
的 概率 。 


下 面 就 介绍 一 个 创建 Archetype 的 样 例 。 首 先 读者 需要 了 解 的 是 ， 
一 个 典型 的 Archetype Maven 项 目 主要 包括 如 下 几 个 部 分 : 


:pom.xml: Archetype 目 身 的 POM ° 


-src/main/resources/archetype-resources/pom.xml: 基于 该 Archetype 


生成 的 项 目的 POM 原 型 。 


-src/main/resources/META-INF/maven/archetype-metadata.xml: 


Archetype 的 描述 符 文 件 。 


-src/main/resources/archetype-resources/**: 其 他 需要 包含 在 


Archetype 中 的 内 容 。 
下 面 结合 样 例 对 上 述 内 容 一 一 评 细 解释 。 


首先 ， 和 任何 其 他 Maven 项 目 一 样 ，Archetype 项 目 自 身 也 需要 有 
一 个 POM 。 这 个 POM 主 要 包含 该 Archetype 的 坐标 信息 ， 这 样 Maven 才 
能 定位 并 使 用 它 。 读 者 还 要 留意 ， 不 要 混 消 Archetype 的 坐标 和 使 用 该 
Archetype 生 成 的 项 目的 坐标 。 需 要 注意 的 是 ， 昌 然 Archetype 可 以 说 是 
一 种 特殊 的 Maven 项 目 ， 但 maven-archetype-plugin 并 没有 要 求 Archetype 
项 目 使 用 特殊 的 打包 类 型 。 因 此 ， 一 般 来 说 ，Archetype 的 打包 类 型 就 
是 默认 值 jar。 代 码 清单 18-1 展 示 了 一 个 很 商 单 的 Archetype 的 POM。 


代码 清单 18-1 样 例 Archetype 的 POM 


ache.org/POM/4.0.0" 
XMLSchema — instance" 
he. org/POM/4.0.0 


2s < /grouplid > 
le < /artifactId > 
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上 来 说 ， 在 编写 Archetype 的 时 候 预 完 定 义 好 其 要 包含 的 目录 结构 和 文 
件 ， 同 时 在 必要 的 地 方 使 用 可 配置 的 属性 声明 替代 硬 编码 。 例 如 ， 项 
目的 坐标 信息 一 般 都 是 可 配置 的 。 代 码 清单 18-2 丈 是 一 个 简单 的 POM 


原型 ， 它 位 于 Archetype 项 目 资源 目录 下 的 archetype-resources/ 子 目录 
中 o 


代码 清单 18-2” 样 例 Archetype 所 包含 的 POM 原 型 


<project xmlns ="http://maven. apache. org/POM/4.0.0" 
xmins:xsi = “http://www. w3.org/2001 /XMLSchema - instance" 
xsi:schemaLocation = “http: //maven. apache. org /POM/4.0.0 
http: //maven. apache. org/xsd/maven —-4.0.0.xsd"> 
<modelVersion >4.0.0 < /modelVersion > 
<groupid > $ {groupId} < /qroupId > 
<artifactId > $ {artifactId}< /artifactId> 
<version > $ (version) < /version> 
<name > $ {artifactId)< /name > 
<url >http://www. juvenxu.com«< /url > 


< dependencies > 
< dependency > 
<groupiId > junit < /groupId > 
<artifactId >junit < /artifactId > 
<version >4.8.1< /version > 
< scope >test < /scope > 
< /dependency > 
< /dependencies > 


<build > 
<pluginManagement > 
<plugins > 
<plugin> 
< groupid> org. apache. maven. plugins < /groupId > 
<artifactId >maven -compiler -plugin < /artifactId > 
<configuration > 
< Source >1.5 </source> 
<target >1,5 </target > 
</ configuration > 
< /plugin > 
<plugin > 
<groupId > org. apache. maven. plugins < /groupId > 
<artifactid >maven -resources -plugin < /artifactia> 
<configuration > 
<encoding >UTF-8 < /encoding > 
< /eonfiguration > 
</plugin > 
< /plugins > 
< /pluginManagement > 
< /build> 
< /project > 


上 述 代 码 片 段 中 的 groupId、artifactId 和 version 等 信息 并 没有 直接 声 
明 ， 而 是 使 用 了 属性 声明 。 回 顾 18.1.2 节 ， 使 用 Archetype 生 成 项 目的 时 
候 ， 用 户 一 般 都 需要 提供 groupId、artifactId、version、package 等 参 


数 ， 在 那个 时 候 ， 这 些 属性 声明 束 会 由 那些 参数 值 填 充 。 


上 述 POM 原 型 中 还 包含 了 一 个 JUnit 依 赖 声 明 和 两 个 插件 配置 。 事 
实 上 ， 我 们 可 以 根据 自己 的 实际 需要 在 这 里 提供 任何 合法 的 POM 配 
置 ， 在 使 用 该 Archetype 生 成 项 目的 时 候 ， 这 些 配置 束 古 现成 的 了 。 


一 个 Archetype 最 核心 的 部 分 是 archetype-metadata.xml 描 述 符 文件 ， 
它 位 于 Archetype 项 目 资 源 目 孙 的 META-INF/maven/ 子 目 孙 下 。 它 主要 
用 来 控制 两 件 事情 : 一 是 声明 哪些 目录 及 文件 应 该 包含 在 Archetype 
中 ; 二 是 这 个 Archetype 使 用 哪些 属性 参数 。 代 码 清早 18-3 展 示 了 一 个 


Archetype 摘 述 从 文件。 


代码 清单 18-3 ” 样 例 Archetype 摘 述 符 文件 


<?xml version = "1.0" encoding = "UTF —8"?> 


<archetype -descriptor name = "sample" > 
<fileSets > 

<fileSet filtered 

<directory > 


"true" packaged 
src/main/java < /d 
< includes > 
<include > * #/*.java</in 
< /includes > 
</fileSet > 
<fileSet filtered 
<directory > 
< includes > 


"true" packaged 
src/test 


/a 


/java<, 

<include > * */*.java</in 
< /includes > 

< /fileSet > 

<fileSet filtered 
<directory >src/main/res 


< includes > 


<include > * * /*.properties < /i 


< /includes > 
< /fileSet > 
</fileSets > 
<requiredProperties > 
<requiredProperty key ="port" /> 
<requiredProperty key = "groupId" > 
<defaultValue 
< /requiredProperty > 
< f/requiredProperties > 


iptor > 


< /archetype -descr 


>com. Juvenxu. mvnboo 


Sere *'S 


irectory > 

clude > 
ears 

Lrectory > 


clude > 


yk < /e 


defaultValue > 


该 例 中 的 Archetype 描 述 符 定义 了 名 称 为 sample。 它 主要 包含 


fileSets 和 requireProperties 两 个 部 分 。 


其 中 ，fileSets 可 以 包含 一 个 或 者 多 


个 fileSet 于 元 素 ， 每 个 fleSet 定 义 一 个 目 好 ， 以 及 与 该 目录 相关 的 包含 


或 排除 规则 。 


上 述 代 码 片 段 中 的 第 一 个 fleSset 指 回 的 目 永 是 srcmain/java， 该 目 
孙 对 应 于 Archetype 项 目 资源 目录 的 archetype-resources/src/maim/java/ 子 


目 永 。 该 fleSet 有 两 个 属性 ，filtered 表 示 
换 。 例 如 ， 像 $$ {x} 这 样 的 内 容 是 否 蔡 换 


Fe TH TIA MPF SRE Dy FAB ES 
为 命令 行 输入 的 x 参数 的 值 ; 


packaged 表 示 是 否 将 该 目录 下 的 内 容 放 到 生成 项 目的 包 路 径 下 。18.1.2 


节 提 到 使 用 Archetype 必 须 提供 的 参数 之 一 就 是 package， 即 项 目 包 名 。 
如 果 读者 暂时 无 法 理解 这 两 个 属性 的 作用 ， 不 必 着 急 ， 稍 后 通过 实例 
来 解释 。 


该 fileSeti 不 包含 了 includes 子 元 隶 ， 并 且 声 明了 一 个 值 为 **/*.java 的 
include 规 则 ， 表 示 包 含 src/main/java/ 中 任意 路 径 下 的 java 文 件 。 这 里 两 
个 星 号 ** 表 示 匹 配 任意 目录 ， 一 个 星 号 * 表 示 匹 配 除 路 径 分 隔 符 外 的 任 
意 0 个 或 者 多 个 字符 。 这 种 匹配 声明 的 方式 在 Maven 的 很 多 插件 中 都 被 
用 到 ， 如 10.5 节 中 的 maven-surefire-plugin。 除 了 includes， 用 户 还 可 以 
使 用 excludes 声 明 要 排除 的 文件 。 配 置 方法 与 cludes 类 似 ， 这 里 不 再 痪 


yit o 


为 了 能 够 说 明 问题 ， 笔 者 在 srcmain/resources/archetype- 
resources/src/main/java/ 目 录 下 创建 了 一 些 文 件 ， 假 设 使 用 该 Archetype 创 
建 项 目的 时 候 ，package 参 数 的 值 为 com.juvenxu.mvnbook。 表 18-1 表 示 
了 Archetype 中 文件 与 生成 项 目 文件 的 对 应 关系 。 


表 18-1 Archetype 资 源 文件 与 所 生成 项 目 文件 的 对 应 天 系 


Archetype 资源 目录 下 生成 的 项 目 根 目录 下 
src/ main/ java/ 
archetype- resources/ src/ main/ java/ oa A j Ja 
i (package = com. juvenxu. mvnbook ) 
App. java com. juvenxu. mvnbook. App. java 
dao/ Dao. java com. juvenxu. mvnbook. dao. Dao. java 


service/ Service. java com. juvenxu. mvnbook. service. Service. java 


如 果 fileSet 的 packaged 属 性 值 为 tue，directory 的 值 为 XxX， 那么 
archetype-resources 下 的 X 目 录 就 会 对 应 地 在 生成 的 项 目 中 被 创建 ， 在 生 
成 项 目的 该 X 目 录 下 还 会 生成 一 个 包 目 录 ， 如 上 例 中 的 
com/juvenxu/mvnbook/， 最 后 Archetype 中 X 目 录 的 子 目录 及 文件 被 复制 
到 生成 项 目 X 目 录 的 包 目 录 下 。 如 果 packaged 的 属性 值 为 false， 那 么 
Archetype 中 X 目 录 下 的 内 容 会 被 直接 复制 到 生成 项 目的 X 目 录 下 。 一 般 
来 说 ，Java 代 码 都 需要 放 到 包 路 径 下 ， 而 项 目 资源 文件 则 不 需要 。 因 
此 ， 在 代码 清单 18-3 中 ， 第 一 、 第 二 个 对 应 Java 文 件 的 科 eSet 的 
packaged 的 属性 为 tue， 而 第 三 个 对 应 资源 文件 的 fleSet 的 packaged 属 性 
为 false。 


还 有 一 点 需要 解释 的 是 fleSet 的 filtered 属 性 ， 它 表示 使 用 参数 值 替 
换 属性 声明 ， 这 征 个 非常 有 用 的 特性 。 例 如 ， 表 18-1 中 涉及 的 儿 个 Java 
类 都 需要 有 package 声 明 ， 而 且 其 值 是 在 项 目 生 成 的 时 候 确 定 的 。 这 时 
就 可 以 在 Java 代 码 中 使 用 属性 声明 ， 如 App.java 的 内 容 应 该 如 代码 清单 
18-4 所 示 。 


代码 清单 18-4 ”Archetype 中 的 App.java 


在 使 用 包 名 com.juvenxu.mvnbook 创 建 项 目 后 ， 上 述 代 码 中 的 第 一 


行 会 变 成 package com.juvenxu.mvnbook; 。 


类 似 地 ，Dao.java 和 Service.java 的 包 声 明 应 该 如 代码 清单 18-5 所 


修 ° 


代码 清单 18-5 ”Archetype 中 的 Dao.java 和 Service.java 


对 应 地 ， 项 目 生 成 后 Dao.java 的 第 一 行 会 成 为 “package 
com.juvenxu.mvnbook.dao; ”， 而 Service.java 的 第 一 行 会 成 为 "package 
com.juvenxu.mvnbook.service; ”。 使 用 这 样 的 技巧 ， 束 可 以 在 
Archetype 中 创建 多 层次 的 Java 代 码 。 


默认 情况 下 ，maven-archetype-plugin 要 求 用 户 在 使 用 Archetype 生 
成 项 目的 时 候 必须 提供 4 个 参数 : groupId、artifactId、version 和 
package。 除 此 之 外 ,用户 在 编写 Archetype 的 时 候 可 以 要 求 额外 的 参 
数 。 人 例如， 代码 请 单 18-3 就 使 用 了 requireProperties 配 置 要 求 额 外 的 port 


参数 ， 这 样 ，Archetype 中 所 有 开局 filtered 的 文件 中 就 可 以 使 用 下 {port} 
属性 声明 ， 然 后 在 项 目 生成 的 时 候 用 命令 行 输入 的 值 填充 。 


X 


此 外 ， 在 编写 Archetype 的 时 候 还 可 以 为 预 置 的 4 个 参数 提供 默认 
值 。 例 如 ， 代 码 清单 18-3 中 惑 为 groupId 参 数 提供 了 默认 信 
com.juvenxu.mvnbook。 在 组 织 内 部 ， 可 能 很 多 项 目的 groupId 是 确定 
的 ， 这 时 就 可 以 为 Archetype 提 供 默 认 的 groupld。 


Archetype 编 写 完 成 之 后 ， 使 用 mvn clean install 将 其 安装 到 本 地 仓 
库 。 接 着 用 户 就 可 以 通过 指定 该 Archetype 的 坐标 用 它 生 成 项 目 了 : 


5 > mvn archetype:generate \ 
—DarchetypeGroupId =com. juvenxu.mvnbook.archetypes \ 
—DarchetypeArtifactId =mvnbook -archetype -sample \ 
—DarchetypeVersion =1.0 - SNAPSHOT 
[INFO] Scanning for projects... 

INFO] 


O a 


[INFO] Building Maven Stub Project (No POM) 1 
ENBG ee 
INFO 
INFO] > > > maven-archetype-plugin:2.0-alpha-5 :generate (default-cli) @ standa 
lone-pom > > > 
INFO] 
INFO] < < < maven-archetype-plugin:2.0-alpha-5 :generate (default-cli) @ an 


[INFO] 

[INFO] ---maven-archetype-plugin:2.0-alpha-5:generate (default-cli) @ standa- 
lone-pom —-— 

[INFO] Generating project in Interactive mode 

[WARNING] No archetype repository found. Falling back to central repository (ht- 
tp://repol.maven. org/mavenz2 ) . 

[WARNING] Use -DarchetypeRepository = <your repository > if archetype's reposito- 
ry is elsewhere. 

[INFO] snapshot com. juvenxu.mvnbook. archetypes :mvnbook- archetype-sample:1.0- 
SNAPSHOT: checking for updates from mvnbook-archetype-sample-repo 

[INFO] Using property: groupId = com. juvenxu.mvynbook 


Define value for property 'artifactId': : test 

Define value for property 'version'’: 1,0 - SNAPSHOT: : 
[INFO] Using property: package = com. juvenxu.mvnbook 
Define value for property 'port': : 8080 


Confirm properties configuration: 

groupId: com. juvenxu. mvnbook 

artifactId: test 

version: 1.0 — SNAPSHOT 

package: com. juvenxu. mvnbook 

port: 8080 

Ee Oy 

(INFO] -—------------—---—----—---—--—-------—-- -_--—_- --—- -—---—-- ——_---—-- —-- 
[INFO] BUILD SUCCESS 

[INFO] —------------------------------------_--—---—_--—----- --—-- -—---—---—-- 
[INFO] Total time: 27.365s 

[INFO] Finished at: Sun May 02 01:13:10 CST 2010 

[INFO] Final Memory: 5M/10M 


(TRIP) 一 


该 例 使 用 了 交互 式 的 方式 生成 项 目 ， 由 于 该 Archetype 为 groupId 定 
义 了 默认 值 ， 用 户 就 不 再 需要 输入 groupId 的 值 了 上。 此外， 用 户 还 不 得 
不 输入 该 Archetype 额 外 定义 的 port 参 数 的 值 。 


18.3 Archetype Catalog 


18.2 节 中 我 们 自 定义 了 一 个 Archetype， 然 后 可 以 通过 指定 该 
Archetype 的 坐标 在 命令 行 用 它 创 建 项 目 原型 。 但 是 ，18.1.2 节 告诉 我 
们 ， 通 常 使 用 Archetype 不 需要 精确 地 指定 Archetype 的 坐标 ，maven- 
archetype-plugin 会 提供 一 个 Archetype 列 表 供 我 们 选择 。 那 么 ， 能 否 把 
目 己 创建 的 Archetype 加 入 到 这 个 列表 中 呢 ? 管 膝 是 肯定 的 。 下 面 束 介 
绍 相关 的 做 法 及 相关 原理 。 


18.3.1 什么 是 Archetype Catalog 


当 用 户 以 不 指定 Archetype 坐 标的 方式 使 用 maven-archetype-plugin 


的 时 候 ， 会 得 到 一 个 Archetype 列 表 供 选择 ， 这 个 列表 的 信息 来 源 于 一 


个 名 为 archetype-catalog.xml 的 文件 。 例 如 ， 代 码 清单 18-6 是 一 个 包 合 了 


两 个 Archetype 信 息 的 archetype-catalog.xml 文 件 。 


代码 清单 18-6 archetype-catalog.xml 


<?xml version = "1.0" encoding = "UTF -8"?> 
<archetype -catalog 
xsi:schemaLocation = "http://maven. apache. org/ plugins / maven — archetype — plu- 
gin/archetype —catalog/1.0.0 
http: //maven. apache. org/xsd/archetype - catalog -1.0.0.xsd" 
xmlns = "http://maven. apache. org/plugins/maven - archetype — plugin/ arche- 
type —catalog/1.0.0 
xmins:xsi = "http://www. w3.org/2001 /XMLSchema — instance" 
<archetypes > 
<archetype > 
<groupId >com. juvenxu.mvnbook. archetypes < /groupId > 
<artifactId >mvnbook -archetype -sample < /artifactId > 
<version >1.0 -SNAPSHOT < /version > 
<description >sample < /description > 


< /archetype > 


<archetype > 
<groupid >org. apache. maven. archetypes 


artifactId >maven -archetype -quickstart 


< /groupid > 
</artifactId> 


<version >1.0 < /version > 
<description >quickstart < /description 


< /archetype > 
< f/archetypes > 
< /archetype -catalog > 


上 述 archetype-catalog.xml 包 含 的 两 个 Archetype 读 者 应 该 已 经 熟悉 


了 ， 第 一 个 Archetype 的 坐标 是 com.juvenxu.mvnbook.archetypes: 
mvnbook-archetype-sample: 1.0-SNAPSHOT， 也 就 是 上 一 节目 定义 的 


Archetype; 第 二 个 则 是 maven-archetype-plugin 默 认 使 用 的 Quickstart 
Archetype。 这 个 XML 非常 简单 ， 它 主要 包含 了 各 个 Archetype 的 坐标 。 
这 样 ， 当 用 户 选 择 使 用 某 个 Archetype 的 时 候 ，Maven 就 能 够 立刻 定位 
到 Archetype 构 件 。 


18.3.2 Archetype Catalogi] yF 


archetype-catalog.xml 能 够 提供 Archetype 的 信息 ， 那 么 maven- 
archetype-plugin 可 以 从 哪些 位 置 读 取 archetype-catalog.xml 文 件 呢 ? 下 面 
是 二 个 0 | 表 : 


yo 


‘internal: 这 是 maven-archetype-plugin 内 置 的 Archetype Catalog, ®, 


含 了 约 58 个 Archetype 信 息 。 


‘local: 81] FA PF ASSAY Archetype Catalog， 其 位 置 为 
~/.m2/archetype-catalog.xml。 需 要 注意 的 是 ， 该 文件 默认 是 不 存在 的 。 


‘remote: 指 同 了 Maven 中 央 仓 库 的 Archetype Catalog， 其 确切 的 地 
址 为 http:/repo1.maven.org/maven2/archetype-Catalog.xml。 在 本 书 编写 
的 时 候 ， 该 Catalog 包 含 了 约 249 个 Archetype 信 息 。 


file: /.: 用 户 可 以 指定 本 机 任何 位 置 的 archetype-catalog.xml 文 
件 。 


http://...: 用 户 可 以 使 用 HTTP 协 议 指 定 远 程 的 archetype-catalog.xml 
文件 。 


当 用 户 运行 mvn archetype: generate 命 令 的 时 候 ， 可 以 使 用 
archetypeCatalog 参 数 指定 插件 使 用 的 Catalog。 例 如 : 


$> mvn archetype: generate -DarchetypeCatalog = file: // /tmp/archetype- cata- 
log. xml 


上 述 命 令 指定 Archetype 插 件 使 用 系统 /tmp 目 永 下 的 archetype- 
catalog.xml 文 件 。 当 然 ， 用 户 不 需要 每 次 运行 Archetype 目 标的 时 候 都 去 
指定 Catalog。 在 maven-archetype-plugin 2.0-beta-4 之 前 的 版 本 中 ， 
archetypeCatalog 的 默认 值 为 “internal，local”"， 即 默认 使 用 插件 内 置 加 上 
用 户 本 机 的 Catalog 信 息 ， 而 从 maven-archetype-plugin 2.0-beta-5 开 始 ， 

这 一 默认 值 变 成 了 “remote，local”， 即 默认 使 用 中 央 仓 库 加 上 用 户 本 机 
的 Catalog 信 息 。 用 户 也 可 以 使 用 逗号 分 隔 多 个 Catalog 来 源 。 例 如 : 


$> mvn archetype: generate -DarchetypeCatalog = file:// /tmp/archetype - cata- 
log. xml,local 


该 命令 指定 Archetype 从 两 个 位 置 读 取 Catalog 信 息 。 


archetype: generate 的 输出 也 会 告诉 用 户 每 一 条 Archetype 信 息 的 来 
例如 : 


Sa 
S 
o 


1: local - > mvnbook -archetype - sample (sar mele ) 

2: local - > maven -archetype -mojo (plug 

3: local - > maven—archetype -quickstart (quickstart) 
å: local - > maven -archetype -webapp (webapp) 


5: internal — > appfuse-basic -jsf (AppFuse archetype... 


6: internal :~ > appfuse-basic- spring (AppF ‘use archetype... 
7: internal - > appfuse -basic -struts (AppFuse archetype... 
8: internal 一 > appfuse-basic- tapestry (AppFuse archetype ... 


9: internal 一 > inert (AppFuse archetype... 


上 述 输 出 片段 告诉 用 户 ，archetype 1-4 来 源 于 本 机 的 
~/.m2/archetype-catalog.xml 文 件 ， 而 archetype 5-9 来 源 于 Archetype 插 件 
内 置 的 archetype-catalog.xml 文 件 。 


18.3.3 ”生成 本 地 仓库 的 Archetype Catalog 


maven-archetype-plugin 提 供 了 一 个 名 为 crawl 的 目标 ， 用 户 可 以 用 
它 来 笛 历 本 地 Maven 仓 库 的 内 容 并 自动 生成 archetype-catalog.xml 文 件 。 
例如 : 


D: ‘tmp >mvn archetype:crawl 

[INFO] Scanning for projects... 

[INFO] 

PNR Ve MN a 


[INFO] Building Maven Stub Project (No POM) 1 


DENDO] sess E E 
[INFO] 
[INFO] ---maven -archetype -plugin:2.0 -alpha -5:crawl (default -cli)@ standa- 


lone -pom ——— 
repository D: \java \repository 
catalogFile null 
[INFO] Scanning D: java \repository \ant \ant \. 
[INFO] Scanning D: \java \repository nt ant \L. 
[INFO] Scanning D: ava \repository \ant \ant 1. 
[INFO] Scanning D: \java \repository nt ‘ant ‘11.6.5 ‘ant -1.6.5.jar 


.1 ‘ant -1.5.1-sources. jar 
-l\ant -1.5.1.jar 
ant -1.6. jar 


uvi 


noon vi 


[INFO] Scanning D: \java \repository \xpp3 \xpp3_min \i.1.4c \xpp3_min -1.1.4c 一 
sources. jar 

[INFO] Scanning D: \java \repository \xpp3 \xpp3_min\1l.1.4c \xpp3_min-1.1.4c. jar 

[INFO] -一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 

[INFO] BUILD SUCCESS 


DEE a a i 
[INFO] Total time: 19.355s 

[INFO] Finished at: Sun May 02 15 :43 :37 CST 2010 

[INFO] Final Memory: 3M/8M 


WR ASE VEEL, crawl B PAWN H Psettings.xml<e SCA) 
localRepository， 并 且 在 该 仓库 的 根 目录 下 生成 archetype-catalog.xml 文 
件 。 用 户 可 以 使 用 参数 repository 指 定 要 遍历 的 Maven 仓 库 ， 使 用 参数 
catalog 指 定 要 更 新 的 catalog 文 件 。 例 如 : 


D: ‘tmp >mvn archetype:crawl -Drepository =-D:/java/repository \ 
Deatalog =C: /archetype — catalog. xml 


将 自 定 义 的 Archetype 安 装 到 本 地 仓库 后 ， 使 用 Archetype: crawl 基 
于 该 仓库 生成 的 Catalog 束 会 包含 该 Archetype 的 信息 ， 接 着 用 户 就 可 以 
在 创建 项 目的 时 候 指定 使 用 该 Catalog 。 


18.3.4 ”使 用 nexus-archetype-plugin 


Nexus 团 队 提 供 了 一 个 名 为 nexus-archetype-plugin 的 插件 ， 该 插件 
能 够 基于 Nexus 仓 库 索 引 实 时 地 生成 archetype-catalog.xml 文 件 。 由 于 
Catalog 内 容 是 基于 仓库 索引 生成 而 不 是 逐个 过 历 仓库 文件 ， 因 此 生成 
的 速度 非常 快 。 只 要 用 户 安 装 了 该 插件 ， 每 个 Nexus 仓 库 都 会 随时 提 
供 一 个 与 索引 内 容 一 致 的 Catalog 。 


用 户 可 以 从 以 下 地 址 下 载 最 新 的 nexus-archetype-plugin: 
http://repository.sonatype.org/content/groups/forge/org/sonatype/nexus/plug 


ins/nexus-archetype-plugin/ ° 


下 一 步 是 将 nexus-archetype-plugin 插 件 的 bundle.zip 包 解压 到 Nexus 
工作 目录 sonatype-work/nexus/ 下 的 plugin-repository/ 子 目录 中 ， 然 后 重 
局 Nexus， 插 件 瓯 安装 完成 了 。 


现在 ， 当 用 户 浏览 Nexus 仓 库 内 容 的 时 候 ， 就 能 够 在 仓库 的 根 目 
录 下 看 到 archetype-catalog.xml 文 件 ， 右 击 选 择 “Download” 后 就 能 下 载 
该 文件 ， 如 图 18-1 所 示 。 


Browse Storage Browse Index 


= Refresh Path Lookup: 
3 Jboss Releases 
D L] .index 
B meta 
日 —j javax 
3 enterprise 
四 站 cdi-api 
Biorg 
SJ) jboss 
B |_) jsr299 
5 _j}seam 
5 (weld 
=] archetype-catalog xmi 


| 


18-1 用 nexus-archetype-plugin 生 成 Archetype Catalog 


18.4 ”小 结 


本 章 详 细 曾 述 了 最 为 有 用 的 Maven 插 件 之 一 : Maven Archetype 
Plugin。 读 者 可 以 选择 以 交互 式 或 者 批 处 理 的 方式 使 用 该 插件 生成 项 


目 骨 架 。 男 外 ， 还 介绍 了 一 些 常用 的 Archetype 。 


本 章 的 重点 是 教授 读者 创建 自己 的 Archetype， 这 主要 包括 理解 
Archetype 项 目的 结构 、 如 何 通过 属性 过 滤 为 Archetype 提 供 灵 活性 ， 以 
及 Archetype Package 参 数 的 作用 。Archetype Plugin 通 过 读 取 Archetype- 
catalog.xml 文 件 内 容 来 提供 可 用 的 Archetype 列 表 信 息 ， 这 样 的 Catalog 
可 以 从 各 个 地 方 获得 ， 如 揪 件 内 置 、 本 机 机 器 、 中 央 仓 库 以 及 自 定 义 
Mfile: /或 http:/ 路 径 。 本 章 最 后 介绍 了 如 何 使 用 archetype: crawl 和 


nexus-archetype-plugin 生 成 仓库 的 archetype-catalog.xml 内 容 。 


附录 A POM 元 素 参 考 


元 素 名 称 
< project > 
< parent > 
< modules > 
< groupld > 
<artifactld > 
< version > 
< packaging > 
< name > 
< description > 
< organization > 
< licenses > < license > 
< mailingLists > </ mailingList > 
< developers > </ developer > 
< contributors > < contributor > 
< issue Management > 
< ciManagement > 
<scm > 
< prerequisites > < maven > 
< build > <sourceDirectory > 
< build > < scriptSourceDirectory > 
< build > <testSourceDirectory > 
< build > < outputDirectory > 
< build > <testOutputDirectory > 
< build > < resources > < resource > 
< build > <testResources > < testResource > 
< build > <finalName > 


<build > < directory > 


fa 人 
POM 的 XML 根 元 素 
声明 继承 
声明 聚合 
坐标 元 素 之 一 
坐标 元 素 之 一 
坐标 元 素 之 一 
坐标 元 素 之 一 ， 默 认 值 jar 
名 称 
描述 
所 属 组 织 
许可 证 
邮件 列表 
开发 者 
贡献 者 
问题 追踪 系统 
持续 集成 系统 
版 本 控制 系统 


要 求 Maven 最 低 版 本 ， 默 认 值 2.0 


主 源码 目录 
SATS Fak 
测试 源码 目录 

主 源码 输出 目录 
测试 源码 输出 目录 
主 资源 目录 
测试 资源 目录 
输出 主 构件 的 名 称 
输出 目录 


参考 章节 


8.3 
8.2 
3:2 
Sz 
S2 
5.2 


8.5. 14.3 
8.5. 14.3 


元 素 名 称 
< build > < filters > < filler > 
< build > < extensions > < extension > 
< build > < pluginManagement > 
< build > < plugins > < plugin > 
< profiles > < profile > 
< distributionManagement > < repository > 


< distribution Management > 
< snapshotRepositery > 


< distributionManagement > < site > 

< repositories > < repository > 

< pluginRepositories > < pluginRepository > 
< dependencies > < dependency > 

< dependencyManagement > 

< properties > 


< reporting > < plugins > 


简 f 
通过 properties 文件 定义 资源 过 滤 属 性 
扩展 Maven 的 核心 
插件 管理 
插件 
POM Profile 


发 布 版 本 部 署 仓 库 
快照 版 本 部 署 仓库 


站 点 部 署 
仓库 

插件 仓库 
依赖 
依赖 管理 
Maven 属性 
报告 插件 


( 续 ) 
参考 章节 


15.7 
8.3.3 
aco 
14. 4 
6.4.2, 9.6.1 


6.4.2, 9.6.1 


15.7 
这 网 
TRl 
5.4 
8.3.3 
14. 1 
15.3 


附录 B SettingsILRE GS 


元 素 名 称 
< settings > 
< localRepository > 
< interactiveMode > 
< offline > 
< pluginGroups > < pluginCroup > 
< servers > < server > 
< mirrors > < mirror > 
< proxies > < proxy > 
< profiles > < profile > 


< activeProfiles > < activeProfile > 


简 全 
settings. xml 文档 的 根 元 素 
本 地 仓库 
Maven 是 否 与 用 户 交 互 ， 上 默认 值 true 
离线 模式 ， 上 默认 值 false 
插件 组 
下 载 与 部 署 仓库 的 认证 信息 
仓库 镜像 
代理 
Settings Profile 
激活 Profile 


参考 章节 


6.3.1 


7.8.4 
Tl 15,7 
6.7 
2.4 
14.4 
14.4.2 


附录 C 


插件 名 称 
maven- clean- plugin 
maven- compiler- plugin 
maven- deploy- plugin 
maven- install- plugin 
maven- resources- plugin 
maven- site- plugin 
maven- surefire- plugin 
maven- jar- plugin 
maven- war- plugin 
maven- shade- plugin 
maven- changelog- plugin 
maven- checkstyle- plugin 
maven- javadoc- plugin 
maven- jxr- plugin 


maven- pmd- plugin 

maven- project- info- reports- plu- 
gin 

maven- surefire- report- plugin 


maven- antrun- plugin 
maven- archetype- plugin 
maven- assembly- plugin 
maven- dependency- plugin 
maven- enforcer- plugin 
maven- pgp- plugin 

maven- help- plugin 
maven- invoker- plugin 
maven- release- plugin 


maven- scm- plugin 


用 Oe 
清理 项 目 
编 详 项 目 
部 署 项 目 
安装 项 目 
处 理 资源 文件 
生成 站 点 
热 行 测试 
构建 JAR 项 目 
构建 WAR 项 目 
yet a Ke JAR 包 
生成 版 本 控制 变更 报告 
生成 CheckStyle 报告 
HEIR JavaDoc 文档 
生成 源码 交叉 引用 文档 
生成 PMD 报告 
生成 项 目 信息 报告 
生成 单元 测试 报告 
调用 Ant 任务 
基于 Archetype 生成 项 目 骨 架 
构建 自 定义 格式 的 分 发 包 
依赖 分 析 及 控制 
定义 规则 并 强制 要 求 项 目 遵守 
为 项 目 构件 生成 PGP 签名 
获取 项 目 及 Maven 环境 的 信息 
自动 运行 Maven 项 目 构建 并 验证 
自动 化 项 目 版 本 发 布 
集成 版 本 控制 系统 


币 用 插件 列表 


来 源 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 
Apache 


参考 章节 
7.2 
7.2 
7.2 
7.2 
7.2, 14.3 
7.2、15 
7.2、10 
7.2 
G2, tA 
3.4 


= A 


13. 6.2 
RE 2 
17.6 
13. 4413.3 


MEH ER 用 途 
maven- source- plugin 生成 源码 所 
maven- eclipse- plugin 生成 Eclipse 项 目 环境 配置 
build- helper- maven- plugin 包含 各 种 支持 构建 生命 周期 的 目标 
exec- maven- plugin 运行 系统 程序 或 者 Java 程序 
jboss- maven- plugin 启动 、 停 止 Jboss, ABSA 
properties- maven- plugin 从 properties 文件 读 写 Maven 属性 
on ee EE 运行 SQL 脚本 
tomcat- maven- plugin 启动 、 停 止 Tomcat、 部 署 项 目 
versions- maven- plugin 自动 化 批 世 更 新 POM 版 本 
ee iets 启动 / 停止 / 配置 各 类 Web F H ah 

化 部 署 Web 项 目 

jetty- maven- plugin 集成 Jetty FAR, RBR RA 
ner eer IR Google App Engine 
maven- license- plugin 自动 化 添加 许可 证 证 明 至 源码 文件 
maven- android- plugin 构建 Android 项 目 


说 明 : 


.来 目 Apache 的 完整 插件 列表 在 : 


http://maven.apache.org/plugins/index.html ° 


.来 和 目 Codehaus 的 完整 插件 列表 在 : 


http://mojo.codehaus.org/plugins.html ° 


来自 Googlecode 的 插件 列表 在 : 
http://code.google.com/hosting/search? 


q=maven+plugin+label%3Amaven&projectsearch=Search+Projects ° 


Apache 
Apache 
Codehaus 
Codehaus 
Codehaus 
Codehaus 
Codehaus 
Codehaus 


Codehaus 


Cargo 


Eclipse 
Googlecode 
Googlecode 
Googlecode 


12.5 


12.4 


(2) 


